Confluence MCP Server
2025.03.31
1
TypeScriptConfluence API 访问内容管理中间件交流协作
Confluence MCP Server 是一个用于访问 Confluence API 的 Model Context Protocol 服务器系统。它使用 Personal Access Token 与 Confluence 进行通信，并在 VPN 区域内作为访问 Confluence API 的中介服务器。该系统由 MCP 服务器和代理服务器两部分组成，旨在解决 VPN 区域访问问题。
View on GitHub
Overview
基本能力
产品定位
Confluence MCP Server 是一个中间件系统，用于在 VPN 环境下安全地访问和操作 Confluence API。
核心功能
- 所有 Confluence 空间列表查询
- 特定空间内的所有页面查询
- 通过页面 ID 查询特定页面信息
- 创建新页面
- 更新现有页面
适用场景
- 在 VPN 限制环境下访问 Confluence API
- 需要集中管理 Confluence 内容的场景
- 自动化 Confluence 内容管理的场景
工具列表
- MCP 服务器：处理与 Confluence API 的通信，提供 RESTful API 和 MCP 协议处理
- 代理服务器：作为 MCP 客户端和 MCP 服务器之间的中介
常见问题解答
- VPN 区域问题：通过分离 MCP 服务器和代理服务器来解决
- "Error fetching spaces: Unable to connect" 错误：可能由 HTTPS 证书问题、网络连接问题或 Personal Access Token 问题引起
- 解决方法：检查
.env文件配置、验证 Personal Access Token、检查网络连接和防火墙设置
使用教程
使用依赖
- Node.js 16.x 或更高版本
- Bun 1.0.0 或更高版本
安装教程
# 克隆存储库
git clone https://github.com/yourusername/confluence-mcp-server.git
cd confluence-mcp-server
# 安装依赖
bun install
环境变量设置
在项目根目录创建 .env 文件并添加以下内容：
PORT=3000
PROXY_PORT=3001
MCP_SERVER_URL=http://localhost:3000
CONFLUENCE_BASE_URL=https://wiki.musinsa.com
PERSONAL_ACCESS_TOKEN=your_personal_access_token
NODE_ENV=development
调试方式
# 开发环境运行 MCP 服务器
bun run dev
# 开发环境运行代理服务器
bun run dev:proxy
# MCP 服务器 Stdio 模式运行
bun run dev:stdio
# 运行测试
bun test