集成应用 MCP 服务器 (SSE)

这是一个远程实现的 MCP (模型上下文协议) 服务器，它通过集成应用提供工具。它允许客户端连接并访问活动连接中的工具，使用 MCP 的 SSE 传输。

要实现你自己的 MCP 客户端，请参阅我们的示例 AI 聊天代理：

• AI 聊天代理 (MCP 客户端应用程序)

前提条件

• Node.js (v14 或更高版本)
• npm 或 yarn
• 一个具有有效 JWT 令牌的集成应用账户

安装

1. 克隆仓库：
   bash
   git clone https://github.com/integration-app/mcpservice
   cd mcpservice

2. 安装依赖项：
   bash
   npm install

3. 构建项目：
   bash
   npm run build

配置

本地开发

要本地运行服务器，请使用以下命令启动：
bash
npm start

服务器将在 http://localhost:3000 上运行。

部署

要将服务器部署到生产环境（例如 Heroku），请按照以下步骤操作：

1. 确保设置了环境变量：

   • PORT：服务器将运行的端口（默认：3000）
   • NODE_ENV：在生产环境中设置为 production

2. 使用你喜欢的托管服务（例如 Heroku、AWS 等）部署你的应用程序。

3. 部署完成后，你的服务器将可以通过类似以下 URL 访问：

   https://your-app-name.herokuapp.com/

连接 URL

要连接到 MCP 服务器，请使用以下 URL 格式：

https://your-app-name.herokuapp.com/sse?token=YOUR_TOKEN

如果服务器在本地运行，则使用：

http://localhost:3000/sse?token=YOUR_TOKEN

Cursor 配置

要与 Cursor 一起使用此服务器，请更新你的 ~/.cursor/mcp.json 文件：
json
{
"mcpServers": {
"integration-app": {
"url": "https://your-app-name.herokuapp.com/sse?token=YOUR_TOKEN"
}
}
}

重启 Cursor 以使更改生效。

Claude 配置

Anthropic 仅允许 MAX 计划或更高级别的 SSE MCP 传输。要与 Claude 一起使用此服务器，请更新你的 ~/claude_desktop_config.json 文件：
json
{
"mcpServers": {
"integration-app": {
"url": "https://your-app-name.herokuapp.com/sse?token=YOUR_TOKEN"
}
}
}

MCP 信息

• 服务器从与提供的令牌关联的所有活动连接中获取工具。
• 服务器支持 SSE (Server-Sent Events) 和可流式 HTTP 传输。

故障排除

• 确保你的 JWT 令牌有效且具有必要的权限。
• 检查服务器日志以查找启动或连接尝试期间的任何错误或问题。
• 确认你的部署环境已正确设置环境变量。