Merge pull request #108 from LeslieLeung/feature/mcp-server

LeslieLeung · web-flow · commit 61d154f50e43 · 2026-01-29T21:20:04.000+08:00
diff --git a/backend/apps/api/glean_api/mcp/server.py b/backend/apps/api/glean_api/mcp/server.py
@@ -51,6 +51,10 @@ def create_mcp_server() -> FastMCP:
         resource_server_url=AnyHttpUrl(settings.mcp_resource_server_url),
     )
 
+    # Use host="0.0.0.0" to disable automatic DNS rebinding protection
+    # which only allows localhost by default. This is necessary for Docker
+    # deployments where the service is accessed via proxy (nginx).
+    # Security is handled at the nginx/reverse proxy layer.
     mcp = FastMCP(
         name="Glean MCP Server",
         instructions="""
@@ -63,6 +67,7 @@ def create_mcp_server() -> FastMCP:
 - list_entries_by_date: List articles within a date range
 - list_subscriptions: List your RSS feed subscriptions
         """.strip(),
+        host="0.0.0.0",
         lifespan=mcp_lifespan,
         auth=auth_settings,
         token_verifier=APITokenVerifier(),
diff --git a/backend/pyproject.toml b/backend/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "glean-backend"
-version = "0.2.4"
+version = "0.2.5"
 description = "Glean Backend - Personal Knowledge Management Tool"
 requires-python = ">=3.11"
 readme = "README.md"
diff --git a/backend/uv.lock b/backend/uv.lock
diff --git a/frontend/apps/admin/package.json b/frontend/apps/admin/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@glean/admin",
-  "version": "0.2.4",
+  "version": "0.2.5",
   "private": true,
   "type": "module",
   "scripts": {
diff --git a/frontend/apps/web/nginx.conf b/frontend/apps/web/nginx.conf
@@ -28,6 +28,20 @@ server {
         proxy_cache_bypass $http_upgrade;
     }
 
+    # MCP server proxy
+    location /mcp {
+        proxy_pass http://backend:8000;
+        proxy_http_version 1.1;
+        proxy_set_header Upgrade $http_upgrade;
+        proxy_set_header Connection 'upgrade';
+        proxy_set_header Host $host;
+        proxy_set_header X-Forwarded-Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+        proxy_set_header X-Forwarded-Proto $scheme;
+        proxy_cache_bypass $http_upgrade;
+    }
+
     # SPA fallback
     location / {
         try_files $uri $uri/ /index.html;
diff --git a/frontend/apps/web/package.json b/frontend/apps/web/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@glean/web",
   "productName": "Glean",
-  "version": "0.2.4",
+  "version": "0.2.5",
   "description": "Glean - Personal Knowledge Management and RSS Reader",
   "author": {
     "name": "Leslie Leung",
diff --git a/frontend/package.json b/frontend/package.json
@@ -1,6 +1,6 @@
 {
   "name": "glean-frontend",
-  "version": "0.2.4",
+  "version": "0.2.5",
   "type": "module",
   "private": true,
   "scripts": {
diff --git a/frontend/packages/api-client/package.json b/frontend/packages/api-client/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@glean/api-client",
-  "version": "0.2.4",
+  "version": "0.2.5",
   "private": true,
   "type": "module",
   "main": "./src/index.ts",
diff --git a/frontend/packages/i18n/package.json b/frontend/packages/i18n/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@glean/i18n",
-  "version": "0.2.4",
+  "version": "0.2.5",
   "private": true,
   "type": "module",
   "main": "./src/index.ts",
diff --git a/frontend/packages/i18n/src/locales/en/settings.json b/frontend/packages/i18n/src/locales/en/settings.json
@@ -161,7 +161,7 @@
       "title": "How to use with MCP",
       "description": "Add your API token to your MCP client configuration to enable AI assistants to search and retrieve articles from your subscriptions.",
       "configTitle": "Claude Desktop Configuration",
-      "urlNote": "Note: Replace the URL with your actual backend API address (e.g., http://localhost:8000/mcp/mcp for local development, or https://your-domain.com/mcp/mcp for production).",
+      "urlNote": "Tip: When using Docker deployment, the URL in the configuration above can be used directly (it's automatically filled with your current domain). Self-hosted users should ensure nginx is configured to proxy the /mcp path.",
       "tools": "Available tools:",
       "toolSearch": "Search articles by keyword",
       "toolGet": "Get full article details",
diff --git a/frontend/packages/i18n/src/locales/zh-CN/settings.json b/frontend/packages/i18n/src/locales/zh-CN/settings.json
@@ -161,7 +161,7 @@
       "title": "如何使用 MCP",
       "description": "将您的 API 令牌添加到 MCP 客户端配置中，以便 AI 助手可以搜索和检索您订阅的文章。",
       "configTitle": "Claude Desktop 配置",
-      "urlNote": "注意：请将 URL 替换为您实际的后端 API 地址（本地开发使用 http://localhost:8000/mcp/mcp，生产环境使用 https://your-domain.com/mcp/mcp）。",
+      "urlNote": "提示：使用 Docker 部署时，上方配置中的 URL 可直接使用（已自动填入当前域名）。自托管用户请确保 nginx 已配置 /mcp 路径代理。",
       "tools": "可用工具：",
       "toolSearch": "按关键词搜索文章",
       "toolGet": "获取文章详情",
diff --git a/frontend/packages/logger/package.json b/frontend/packages/logger/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@glean/logger",
-  "version": "0.2.4",
+  "version": "0.2.5",
   "private": true,
   "type": "module",
   "main": "./src/index.ts",
diff --git a/frontend/packages/types/package.json b/frontend/packages/types/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@glean/types",
-  "version": "0.2.4",
+  "version": "0.2.5",
   "private": true,
   "type": "module",
   "main": "./src/index.ts",
diff --git a/frontend/packages/ui/package.json b/frontend/packages/ui/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@glean/ui",
-  "version": "0.2.4",
+  "version": "0.2.5",
   "private": true,
   "type": "module",
   "main": "./src/index.ts",
diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "glean",
-  "version": "0.2.4",
+  "version": "0.2.5",
   "private": true,
   "scripts": {
     "dev": "concurrently --handle-input --kill-others --kill-signal SIGINT --kill-timeout 5000 -n api,worker,web,admin -c blue,green,yellow,magenta \"make api\" \"make worker\" \"make web\" \"make admin\"",

Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@glean/admin",`
`3`		`- "version": "0.2.4",`
	`3`	`+ "version": "0.2.5",`
`4`	`4`	`"private": true,`
`5`	`5`	`"type": "module",`
`6`	`6`	`"scripts": {`
Original file line number	Diff line number	Diff line change
`@@ -1,7 +1,7 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@glean/web",`
`3`	`3`	`"productName": "Glean",`
`4`		`- "version": "0.2.4",`
	`4`	`+ "version": "0.2.5",`
`5`	`5`	`"description": "Glean - Personal Knowledge Management and RSS Reader",`
`6`	`6`	`"author": {`
`7`	`7`	`"name": "Leslie Leung",`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "glean-frontend",`
`3`		`- "version": "0.2.4",`
	`3`	`+ "version": "0.2.5",`
`4`	`4`	`"type": "module",`
`5`	`5`	`"private": true,`
`6`	`6`	`"scripts": {`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@glean/api-client",`
`3`		`- "version": "0.2.4",`
	`3`	`+ "version": "0.2.5",`
`4`	`4`	`"private": true,`
`5`	`5`	`"type": "module",`
`6`	`6`	`"main": "./src/index.ts",`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@glean/i18n",`
`3`		`- "version": "0.2.4",`
	`3`	`+ "version": "0.2.5",`
`4`	`4`	`"private": true,`
`5`	`5`	`"type": "module",`
`6`	`6`	`"main": "./src/index.ts",`