|
1 | 1 | # @gleanwork/local-mcp-server |
2 | 2 |
|
3 | | - |
4 | | - |
5 | | -[](https://badge.fury.io/js/@gleanwork%2Flocal-mcp-server) |
6 | | -[](https://github.com/gleanwork/mcp-server/blob/main/LICENSE) |
| 3 | +> [!IMPORTANT] |
| 4 | +> This package is deprecated / no longer maintained. |
| 5 | +> |
| 6 | +> Do not use `@gleanwork/local-mcp-server` for new MCP setups. It predates Glean’s managed remote MCP server and is no longer the supported path for connecting MCP-compatible hosts to Glean. |
7 | 7 |
|
8 | | -> [!WARNING] |
9 | | -> We recommend using the [remote MCP server integrated directly in Glean](https://docs.glean.com/administration/platform/mcp/about) instead of this local MCP server. The remote server provides a more seamless experience with automatic updates, better performance, and simplified configuration. For local usage, consider [Glean CLI](https://github.com/gleanwork/glean-cli). This local MCP server is primarily intended for experimental and testing purposes. |
| 8 | +## What to use instead |
10 | 9 |
|
11 | | -The Glean MCP Server is a [Model Context Protocol (MCP)](https://modelcontextprotocol.io/introduction) server that provides seamless integration with Glean's enterprise knowledge. |
| 10 | +Use the managed Glean MCP server built into your Glean instance: |
12 | 11 |
|
13 | | -## Features |
| 12 | +- [Using the Glean MCP Server](https://docs.glean.com/user-guide/mcp/usage) — end-user setup for supported MCP hosts. |
| 13 | +- [Set up Glean MCP server](https://docs.glean.com/administration/platform/mcp/enable-mcp-servers) — admin setup and enablement. |
| 14 | +- [About Glean MCP server](https://docs.glean.com/administration/platform/mcp/about) — overview of Glean’s managed MCP server. |
14 | 15 |
|
15 | | -- **Company Search**: Access Glean's powerful content search capabilities |
16 | | -- **People Profile Search**: Access Glean's people directory |
17 | | -- **Chat**: Interact with Glean's AI assistant |
18 | | -- **Read Documents**: Retrieve documents from Glean by ID or URL |
19 | | -- **MCP Compliant**: Implements the Model Context Protocol specification |
| 16 | +For local command-line workflows, use [Glean CLI](https://github.com/gleanwork/glean-cli) instead. |
20 | 17 |
|
21 | | -## Tools |
| 18 | +## Package status |
22 | 19 |
|
23 | | -- ### company_search |
| 20 | +`@gleanwork/local-mcp-server` is being retired in favor of the managed Glean MCP server. No new feature work or bug fixes are planned for this package. |
24 | 21 |
|
25 | | - Search Glean's content index using the Glean Search API. This tool allows you to query Glean's content index with various filtering and configuration options. |
| 22 | +Do not treat this package as an actively maintained MCP surface. Existing users should migrate to the managed Glean MCP server where possible. |
26 | 23 |
|
27 | | -- ### chat |
| 24 | +## Historical note |
28 | 25 |
|
29 | | - Interact with Glean's AI assistant using the Glean Chat API. This tool allows you to have conversational interactions with Glean's AI, including support for message history, citations, and various configuration options. |
| 26 | +This package previously implemented a local stdio-based Model Context Protocol server for Glean. It exposed tools for: |
30 | 27 |
|
31 | | -- ### people_profile_search |
| 28 | +- Glean company search |
| 29 | +- Glean Chat |
| 30 | +- People profile search |
| 31 | +- Document reading |
32 | 32 |
|
33 | | - Search Glean's People directory to find employee information. |
| 33 | +That local implementation was useful before Glean’s managed remote MCP server was available. The managed server is now the supported path and provides centralized enablement, OAuth-based setup, and a better long-term support model. |
34 | 34 |
|
35 | | -- ### read_documents |
| 35 | +## Historical reference only |
36 | 36 |
|
37 | | - Read documents from Glean by providing document IDs or URLs. This tool allows you to retrieve the full content of specific documents for detailed analysis or reference. |
38 | | - |
39 | | -## MCP Client Configuration |
40 | | - |
41 | | -To configure this MCP server in your MCP client (such as Claude Desktop, Windsurf, Cursor, etc.), run [@gleanwork/configure-mcp-server](https://github.com/gleanwork/configure-mcp-server) passing in your client, token and instance. |
42 | | - |
43 | | -```bash |
44 | | -# Configure for Cursor |
45 | | -npx @gleanwork/configure-mcp-server --client cursor --token your_api_token --server-url https://your-company-be.glean.com |
46 | | - |
47 | | -# Configure for Claude Desktop |
48 | | -npx @gleanwork/configure-mcp-server --client claude --token your_api_token --server-url https://your-company-be.glean.com |
49 | | - |
50 | | -# Using deprecated --instance flag (use --server-url instead) |
51 | | -# npx @gleanwork/configure-mcp-server --client cursor --token your_api_token --instance instance_name |
52 | | -``` |
53 | | - |
54 | | -For more details see: [@gleanwork/configure-mcp-server](https://github.com/gleanwork/configure-mcp-server). |
55 | | - |
56 | | -### Manual MCP Configuration |
57 | | - |
58 | | -To manually configure an MCP client (such as Claude Desktop, Windsurf, Cursor, etc.), add the following configuration to your MCP client settings: |
59 | | - |
60 | | -```json |
61 | | -{ |
62 | | - "mcpServers": { |
63 | | - "glean": { |
64 | | - "command": "npx", |
65 | | - "args": ["-y", "@gleanwork/local-mcp-server"], |
66 | | - "env": { |
67 | | - "GLEAN_SERVER_URL": "<glean server URL>", |
68 | | - "GLEAN_API_TOKEN": "<glean api token>" |
69 | | - } |
70 | | - } |
71 | | - } |
72 | | -} |
73 | | -``` |
74 | | - |
75 | | -Replace the environment variable values with your actual Glean credentials. |
76 | | - |
77 | | -## Docker Deployment |
78 | | - |
79 | | -As an alternative to npx, you can run the Glean MCP server in a Docker container. This provides isolation and consistent runtime environments. |
80 | | - |
81 | | -Multi-architecture Docker images are published to GitHub Container Registry and work on both Intel/AMD (amd64) and Apple Silicon (arm64) systems. |
82 | | - |
83 | | -### Pull the Image |
84 | | - |
85 | | -```bash |
86 | | -docker pull ghcr.io/gleanwork/local-mcp-server:latest |
87 | | -``` |
88 | | - |
89 | | -If you see `denied` / `403 Forbidden` when pulling from GHCR, authenticate first: |
90 | | - |
91 | | -```bash |
92 | | -# Token must include read:packages |
93 | | -echo "$GITHUB_TOKEN" | docker login ghcr.io -u "$GITHUB_USERNAME" --password-stdin |
94 | | -docker pull ghcr.io/gleanwork/local-mcp-server:latest |
95 | | -``` |
96 | | - |
97 | | -If GHCR access is blocked in your environment, you can build locally: |
98 | | - |
99 | | -```bash |
100 | | -docker build -t glean/local-mcp-server:local . |
101 | | -``` |
102 | | - |
103 | | -### MCP Client Configuration |
104 | | - |
105 | | -Configure your MCP client to use the Docker image. Most MCP clients support passing environment variables via the `env` block: |
106 | | - |
107 | | -```json |
108 | | -{ |
109 | | - "mcpServers": { |
110 | | - "glean": { |
111 | | - "command": "docker", |
112 | | - "args": [ |
113 | | - "run", |
114 | | - "-i", |
115 | | - "--rm", |
116 | | - "ghcr.io/gleanwork/local-mcp-server:latest" |
117 | | - ], |
118 | | - "env": { |
119 | | - "GLEAN_SERVER_URL": "https://your-instance-be.glean.com", |
120 | | - "GLEAN_API_TOKEN": "your-token" |
121 | | - } |
122 | | - } |
123 | | - } |
124 | | -} |
125 | | -``` |
126 | | - |
127 | | -If your MCP client doesn't pass the `env` block to Docker, use `-e` flags in the args instead: |
128 | | - |
129 | | -```json |
130 | | -{ |
131 | | - "mcpServers": { |
132 | | - "glean": { |
133 | | - "command": "docker", |
134 | | - "args": [ |
135 | | - "run", |
136 | | - "-i", |
137 | | - "--rm", |
138 | | - "-e", |
139 | | - "GLEAN_SERVER_URL=https://your-instance-be.glean.com", |
140 | | - "-e", |
141 | | - "GLEAN_API_TOKEN=your-token", |
142 | | - "ghcr.io/gleanwork/local-mcp-server:latest" |
143 | | - ] |
144 | | - } |
145 | | - } |
146 | | -} |
147 | | -``` |
148 | | - |
149 | | -**Important:** The `-i` flag is required for stdio transport communication. |
150 | | - |
151 | | -### Environment Variables |
152 | | - |
153 | | -- `GLEAN_SERVER_URL` (recommended): Your Glean server URL (e.g. `https://your-instance-be.glean.com`) |
154 | | -- `GLEAN_INSTANCE`: Your Glean instance name (deprecated alternative to `GLEAN_SERVER_URL`) |
155 | | -- `GLEAN_API_TOKEN` (required): Your Glean API token |
156 | | - |
157 | | -### Troubleshooting |
158 | | - |
159 | | -**Container exits immediately:** |
160 | | - |
161 | | -- Verify environment variables are set correctly |
162 | | -- Check Docker logs: `docker logs <container-id>` |
163 | | -- Ensure the `-i` flag is present in the args |
164 | | - |
165 | | -**Permission or authentication errors:** |
166 | | - |
167 | | -- Verify your `GLEAN_API_TOKEN` is valid |
168 | | -- Check your `GLEAN_SERVER_URL` or `GLEAN_INSTANCE` matches your Glean deployment |
169 | | - |
170 | | -**`docker pull` returns `denied` or `403 Forbidden`:** |
171 | | - |
172 | | -- Authenticate to `ghcr.io` with a token that has `read:packages` |
173 | | -- Retry pull with the same image/tag |
174 | | -- If this persists, open an issue with your exact pull command and error output |
175 | | - |
176 | | -**MCP client can't connect:** |
177 | | - |
178 | | -- Verify Docker is installed and running |
179 | | -- Check that `docker` command is in your PATH |
180 | | -- Review MCP client logs for error messages |
181 | | - |
182 | | -**Environment variables not being passed:** |
183 | | - |
184 | | -- Try using `-e` flags in args instead of the `env` block (see alternative configuration above) |
185 | | - |
186 | | -### Docker Compose |
187 | | - |
188 | | -For standalone deployment scenarios, a docker-compose example is available in [examples/docker-compose.yaml](../../examples/docker-compose.yaml). This demonstrates how to run the MCP server with Docker Compose, including resource limits and security options. |
189 | | - |
190 | | -Note: Most MCP clients manage container lifecycle directly, so docker-compose is primarily useful for testing or custom deployment scenarios. |
191 | | - |
192 | | -### Debugging |
193 | | - |
194 | | -Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the [MCP Inspector](https://github.com/modelcontextprotocol/inspector), which is available as a package script: |
195 | | - |
196 | | -```bash |
197 | | -npm run inspector |
198 | | -``` |
199 | | - |
200 | | -The Inspector will provide a URL to access debugging tools in your browser. |
201 | | - |
202 | | -## Contributing |
203 | | - |
204 | | -Please see [CONTRIBUTING.md](https://github.com/gleanwork/mcp-server/blob/main/CONTRIBUTING.md) for development setup and guidelines. |
| 37 | +Install, Docker, environment-variable, and MCP client configuration instructions have intentionally been removed from this README so new users are not directed toward an unsupported setup. If you need to understand the old implementation or recover old setup details, inspect the repository history. |
205 | 38 |
|
206 | 39 | ## License |
207 | 40 |
|
208 | | -MIT License - see the [LICENSE](LICENSE) file for details |
209 | | - |
210 | | -## Support |
211 | | - |
212 | | -- Documentation: [docs.glean.com](https://docs.glean.com) |
213 | | -- Issues: [GitHub Issues](https://github.com/gleanwork/mcp-server/issues) |
| 41 | +MIT License — see the repository [LICENSE](../../LICENSE) file for details. |
0 commit comments