Confluence MCP 服务器

用于访问 Confluence API 的模型上下文协议服务器系统。使用个人访问令牌与 Confluence 进行通信。充当访问 VPN 区域内的 Confluence API 的中介服务器。

系统配置

该项目由两台服务器组成：

1. MCP 服务器（server.ts）：与 Confluence API 通信并处理数据的主服务器。
   • 默认端口：3000
   • 提供 RESTful API
   • MCP 协议处理
2. 代理服务器（proxyServer.ts）：充当 MCP 客户端和 MCP 服务器之间的代理。
   • 默认端口：3001
   • 接收来自 MCP 客户端的请求并将其转发到主服务器

该架构旨在解决VPN域问题。 MCP 服务器在 VPN 内部运行并访问 Confluence API，而代理服务器在外部可访问的环境中运行。

功能

• 查看所有 Confluence 空间的列表
• 查看特定空间内的所有页面
• 通过页面ID获取特定页面信息
• 创建新页面
• 更新现有页面

安装和设置

先决条件

• Node.js 16.x 或更高版本
• Bun 1.0.0 或更高版本

安装

设置环境变量

在项目根目录中创建一个.env文件并添加以下内容：

执行

开发环境

生产环境

端点

MCP 服务器端点（默认端口：3000）

• POST /mcp - 处理 MCP 请求的主端点。
• GET /mcp/tools - 列出可用工具
• GET /api/spaces - 列出所有空间
• GET /api/spaces/:spaceKey/pages - 检索特定空间中的页面列表
• GET /api/pages/:pageId - 检索有关特定页面的信息
• POST /api/pages - 创建新页面
• PUT /api/pages/:pageId - 更新页面
• GET /health - 检查服务器健康状况

代理服务器端点（默认端口：3001）

• POST /mcp - 接收 MCP 客户端请求并将其转发到 MCP 服务器。
• GET /tools - 列出可用工具
• GET /health - 检查代理服务器状态

故障排除

排查 VPN 区域问题

该项目已拆分为两个服务器以解决 VPN 区域问题：

1. MCP 服务器在 VPN 内部运行并直接访问 Confluence API。
2. 代理服务器在外部可访问的环境中运行并接收来自 MCP 客户端的请求。

当 MCP 客户端无法直接访问 Confluence API 时，此配置充当中介。

错误“获取空间时出错：无法连接”

此错误可能由以下问题引起：

1. HTTPS 证书问题：在开发环境中禁用 SSL 证书验证，但在生产环境中需要正确设置证书。
2. 网络连接问题：这可能是由于防火墙或代理设置阻止您访问 Confluence 服务器。
3. 个人访问令牌问题：令牌可能已过期或格式错误。

如何解决

1. 确保.env文件中的CONFLUENCE_BASE_URL正确。
2. 验证您的个人访问令牌是否有效。
3. 检查您的防火墙设置以确保您可以访问您的 Confluence 服务器。
4. 请联系您的网络管理员来验证访问权限。
5. 确保 MCP 服务器和代理服务器之间的连接设置正确（设置MCP_SERVER_URL ）。

测试

分发配置

推荐的分发配置

对于生产环境，我们建议采用以下部署配置：

1. MCP 服务器：部署在 VPN 内部或可以访问 Confluence 服务器的网络上。
2. 代理服务器：部署在 MCP 客户端可访问的网络上。

安全注意事项

• 我们建议使用 HTTPS 加密代理服务器和 MCP 服务器之间的通信。
• 请妥善保管您的个人访问令牌，并根据需要定期更新。
• 在生产环境中，添加适当的身份验证机制，以防止未经授权访问代理服务器。

执照

麻省理工学院