使用说明
汇流MCP服务器
A. 模型上下文协议（MCP） Confluence服务器——CQL支持的页面搜索、读取、创建、更新、评论和空间/页面列表。专为调查期间的安全知识库管理和IR runbook访问而构建。
快速开始
克劳德桌面（stdio）
将以下内容添加到您的 claude_desktop_config.json:
{
"mcpServers": {
"confluence": {
"command": "npx",
"args": ["-y", "@tocharianou/confluence-mcp"],
"env": {
"CONFLUENCE_HOST": "https://yourorg.atlassian.net",
"CONFLUENCE_EMAIL": "you@company.com",
"CONFLUENCE_TOKEN": "<your-api-token>"
}
}
}
}
获取Atlassian API代币，网址： id.atlassian.com/manage-profile/security/api-tokens.
HTTP/流模式
MCP_TRANSPORT=http MCP_HTTP_PORT=3003 CONFLUENCE_HOST=https://yourorg.atlassian.net CONFLUENCE_EMAIL=you@company.com CONFLUENCE_TOKEN=<token> npx @tocharianou/confluence-mcp
然后将您的MCP客户端指向 http://localhost:3003/mcp.
特性
- CQL搜索 --使用空间过滤跨页面和博客文章进行全文搜索
- 页面读/写 --阅读运行手册，创建事后分析，更新IR文档
- 评论管理 --将调查笔记直接添加到Confluence页面
- 太空探索 --列出并探索所有可访问的Confluence空间
- 令牌限制 --内置
MAX_TOKEN_CALL保护防止上下文溢出
配置
| 环境变量 | 必填 | 说明 |
|---|---|---|
CONFLUENCE_HOST |
✓ | 汇流云： https://yourorg.atlassian.net /服务器： https://wiki.company.com |
CONFLUENCE_EMAIL |
✓* | Atlassian帐户电子邮件（仅限云端；服务器/DC留空） |
CONFLUENCE_TOKEN |
✓ | API令牌（云）或个人访问令牌（服务器/数据中心） |
CONFLUENCE_API_VERSION |
– | v2 对于Cloud（默认）， v1 服务器/数据中心 |
CONFLUENCE_VERIFY_SSL |
– | true/false （默认值： true) |
MAX_TOKEN_CALL |
– | 每个工具响应的令牌限制（默认值： 20000) |
MCP_TRANSPORT |
– | stdio （默认）或 http |
MCP_HTTP_PORT |
– | HTTP服务器端口（默认值： 3003) |
MCP_HTTP_HOST |
– | HTTP服务器主机（默认值： localhost) |
* CONFLUENCE_EMAIL 是Confluence Cloud所必需的。为Confluence服务器/数据中心留空（仅使用PAT）。
可用工具
| 工具 | 说明 |
|---|---|
confluence_health_check |
测试连接，验证帐户信息和可访问空间计数 |
search_content |
跨页面和博客文章的CQL全文搜索，带有摘录预览 |
get_page |
按ID或标题阅读特定页面的完整内容 |
create_page |
在空间中创建新页面（尸检、IR记录、调查结果） |
update_page |
更新现有页面的内容或标题 |
add_comment |
在页面中添加内联注释以记录调查笔记 |
list_spaces |
列出所有可访问的Confluence空间，并附上关键字和描述 |
list_pages_in_space |
列出特定空间中的页面，可选择按父页面筛选 |
查询示例
- “在Confluence上搜索我们的勒索软件事件IR剧本”
- “在SEC空间中查找AWS密钥泄露的runbook”
- “获取“事件响应程序”页面的全部内容”
- “在SEC空间创建一个验尸页面，总结我的调查结果”
- “使用我发现的误报模式在SIEM警报页面上添加注释”
调试
使用MCP检查器进行测试和调试：
npm run inspector
服务器日志被写入 标准错误 因此它们不会干扰stdout上的MCP JSON-RPC流。
故障排除
| 症状 | 可能原因 |
|---|---|
401 Unauthorized |
无效 CONFLUENCE_TOKEN 或错误 CONFLUENCE_EMAIL |
403 Forbidden |
空间或页面权限不足 |
404 Not Found |
页面ID或空格键不存在 |
ECONNREFUSED |
错了 CONFLUENCE_HOST 或无法访问Confluence服务器 |
| SSL错误 | 设置 CONFLUENCE_VERIFY_SSL=false 用于自签名证书（仅限服务器/DC） |
| 超出令牌限制 | 设置 excerpt_only: true 或使用 break_token_rule: true |
发展
git clone https://github.com/TocharianOU/confluence-mcp.git
cd confluence-mcp
npm install --ignore-scripts
npm run build
cp .env.example .env # fill in your credentials
npm start
发布
看 发布.md 完整的发布流程。
许可证
Apache 2.0--版权所有©2024 TocharianOU贡献者
