你好，这是README
上下文中心MCP服务器
用TypeScript实现的最小模型上下文协议（MCP）服务器，公开了示例工具、动态资源和提示。旨在作为构建更丰富服务器或与其他MCP服务器组合的起点。
特性
- 工具:
- echo -回应提供的消息 - add_numbers -将两个数字相加
- 资源：动态问候(
greeting://{name}) - 提示:
review_code-代码审查提示模板 - 运输:
stdio用于本地集成（VS Code、Claude Desktop、MCP Inspector）
聚合器和API扩展
除了这个最小的例子，这个项目现在还包括一个多服务器聚合器(src/multi-server.ts)即：
- 连接到中定义的多个外部MCP服务器
mcp_servers.json(servers阵列） - 动态列出和委派远程工具/资源(
list_remote_tools,call_remote_tool等等） - 适配声明性REST API定义（
apis阵列）转换为MCP工具（例如。google_search) - 通过以下方式提供实验性的OAuth支持工具（Google Drive列表）
oauthProviders配置
运行聚合器
npm run build
node build/multi-server.js然后使用MCP Inspector或客户端调用新工具。
配置文件(mcp_servers.json)
关键部分：
servers：外部MCP进程（文件系统、内存等）apis：具有查询参数映射和环境注入的进程中REST适配器oauthProviders：OAuth客户端凭据+用于令牌刷新授权的刷新令牌
OAuth提供者示例（占位符-替换为实际值）：
"oauthProviders": [
{
"name": "google",
"clientId": "${GOOGLE_CLIENT_ID}",
"clientSecret": "${GOOGLE_CLIENT_SECRET}",
"refreshToken": "${GOOGLE_REFRESH_TOKEN}",
"tokenEndpoint": "https://oauth2.googleapis.com/token",
"scopes": ["https://www.googleapis.com/auth/drive.readonly"]
}
]价值观包装如下 ${VARNAME} 在启动时从环境变量中替换。在启动之前设置它们：
export GOOGLE_CLIENT_ID="your-client-id.apps.googleusercontent.com"
export GOOGLE_CLIENT_SECRET="your_client_secret"
export GOOGLE_REFRESH_TOKEN="1//04ABCDEF..."获取Google OAuth凭据和刷新令牌
- 在Google Cloud Console中创建/选择项目。
- 启用所需的API（例如驱动API，自定义搜索已使用API密钥而不是OAuth）。
- 配置OAuth同意屏幕（个人使用时为外部；需要时发布）。
- 创建OAuth客户端ID:
- 应用程序类型：“桌面”（简化安装的应用程序流）或具有环回重定向的“Web”
http://127.0.0.1:8085/callback.
- 生成授权URL:
AUTH_URL="https://accounts.google.com/o/oauth2/v2/auth?client_id=$GOOGLE_CLIENT_ID&redirect_uri=http://127.0.0.1:8085/callback&response_type=code&scope=https%3A%2F%2Fwww.googleapis.com%2Fauth%2Fdrive.readonly&access_type=offline&prompt=consent"
echo $AUTH_URL
open "$AUTH_URL" # macOS opens browser- 捕获授权码：
- 运行一个小监听器（Python示例）：
python - =18
- npm或兼容的包管理器
## 快速开始
### 1.安装依赖项
**重要**：如果使用企业npm注册表，请先切换到公共注册表：
npm config set registry https://registry.npmjs.org/
然后安装：
npm install
### 2.建造
npm run build
这将TypeScript编译为 `build/index.js`.
### 3.使用MCP检验员进行测试
npx @modelcontextprotocol/inspector node build/index.js
**什么是MCP检查员？**
检查员是 **调试和测试工具** （想想“MCP服务器的邮递员”）。它提供了一个web UI，用于：
- 发现服务器公开的内容（工具/资源/提示）
- 无需编写客户端代码即可测试单个操作
- 实时查看JSON-RPC消息和响应
- 在与AI应用程序集成之前调试问题
**为什么要使用它？**
✅ **快速开发周期**：测试立即更改，无需重新启动Claude/VS代码\
✅ **隔离**：分别调试服务器逻辑和客户端行为\
✅ **能见度**：查看确切的请求/响应有效载荷以进行故障排除\
✅ **文档**：了解工具接受哪些参数
**检查员展示了什么：**
浏览器打开到 `http://localhost:6274` 有4个主要选项卡：
#### **工具选项卡**
列出所有可调用工具及其模式。尝试：
- 点击 `echo` → Enter `{"message": "hello"}` → 点击“呼叫工具”
- 点击 `add_numbers` → Enter `{"a": 5, "b": 3}` → 查看结果 `{"result": 8}`
#### **资源选项卡**
显示可用资源（数据源）。尝试：
- 点击 `greeting://Alice` → 查看回复：“你好，爱丽丝！欢迎来到上下文中心。”
- 更改 `greeting://World` → 获取自定义问候语
#### **提示选项卡**
显示提示模板。尝试：
- 点击 `review_code` → Enter `{"code": "function add(a,b){return a+b}"}`
- 查看嵌入代码的生成提示消息
#### **通知窗格**
显示服务器日志和JSON-RPC流量以进行调试。
**快速测试命令：**
If port 6274 is busy, kill existing inspector:
lsof -ti:6274 | xargs kill -9
Then restart:
npx @modelcontextprotocol/inspector node build/index.js
按 **Ctrl+C** 在终端中停止检查器和服务器。
### 4.与VS代码一起使用
添加到 `.vscode/mcp.json` （已创建）：
{ "servers": { "context-hub": { "type": "stdio", "command": "node", "args": ["/absolute/path/to/MCP_Spike/build/index.js"] } } }
替换 `/absolute/path/to/MCP_Spike` 与您的项目路径。
### 5.与克劳德桌面一起使用
添加到 `~/Library/Application Support/Claude/claude_desktop_config.json` （macOS）或 `%APPDATA%\Claude\claude_desktop_config.json` （Windows）：
{ "mcpServers": { "context-hub": { "command": "node", "args": ["/absolute/path/to/MCP_Spike/build/index.js"] } } }
重新启动克劳德桌面。
## 发展模式
直接使用ts节点运行（无构建步骤）：
npm run dev
**备注**：服务器无限期运行，等待MCP客户端通过stdio连接。这是正常行为——按Ctrl+C停止。
## 延伸
- 添加新工具 `server.registerTool(name, config, handler)`.
- 添加资源 `server.registerResource(name, templateOrUri, metadata, handler)`.
- 添加提示 `server.registerPrompt(name, config, handler)`.
请参阅TypeScript SDK文档：https://github.com/modelcontextprotocol/typescript-sdk
## 许可证
麻省理工学院