使用说明
汇流mcp
用于人工智能代理的快速手术汇流MCP服务器。
是什么让它与众不同
与通用Atlassian MCP服务器不同，此服务器 仅汇流 并针对AI代理如何实际处理文档进行了优化：
- 手术部分编辑 --在不接触页面其余部分的情况下，通过标题名称更新单个部分
- 快速下载页面树 --在一次调用中获取整个页面层次结构
- 智能图像处理 --将图像作为附件上传并自动嵌入到页面中
- Markdown输入/输出 --在标记中读写；存储格式转换是自动的
- 查找与替换 --简单的文本替换，保留所有HTML结构
- 节意识阅读 --只获取您需要的部分，而不是整个页面
安装
通过uvx（建议MCP客户使用）
uvx --from git+https://github.com/1vecera/confluence-mcp confluence-mcp
通过pip
pip install git+https://github.com/1vecera/confluence-mcp
配置
设置这些环境变量：
CONFLUENCE_URL=https://yoursite.atlassian.net
CONFLUENCE_USERNAME=you@company.com
CONFLUENCE_API_TOKEN=your-api-token
获取API令牌的位置：https://id.atlassian.com/manage-profile/security/api-tokens
Claude代码配置
添加 ~/.claude.json:
{
"mcpServers": {
"confluence": {
"command": "uvx",
"args": ["--from", "git+https://github.com/1vecera/confluence-mcp", "confluence-mcp"],
"env": {
"CONFLUENCE_URL": "https://yoursite.atlassian.net",
"CONFLUENCE_USERNAME": "you@company.com",
"CONFLUENCE_API_TOKEN": "your-token"
}
}
}
}
工具
阅读
| 工具 | 说明 |
|---|---|
get_page |
以markdown或存储格式获取页面内容 |
get_page_tree |
一次下载整个页面层次结构 |
get_page_sections |
列出所有部分及其内容 |
get_section |
通过标题名称获取特定部分 |
search_pages |
通过CQL或简单文本搜索 |
list_page_images |
列出页面中的所有图像引用 |
书写（外科）
| 工具 | 说明 |
|---|---|
update_page |
更新整个页面内容 |
update_section |
仅替换特定部分——关键的手术编辑工具 |
append_to_section |
将内容添加到节的末尾 |
find_replace_in_page |
查找并替换保留文本的HTML |
create_page |
创建新页面 |
附件和图像
| 工具 | 说明 |
|---|---|
list_attachments |
列出页面上的所有附件 |
download_attachment |
按文件名下载附件 |
upload_attachment |
上传文件附件 |
upload_image_and_embed |
上传图片+可选择重写页面以嵌入 |
标签
| 工具 | 说明 |
|---|---|
get_labels |
在页面上获取标签 |
add_label |
向页面添加标签 |
示例
手术科更新
与其下载并重新上传整个页面：
update_section(page_id="123456", heading="Status", new_content="Project is **on track** for Q2 delivery.")
下载整个文档树
get_page_tree(page_id="123456", include_body=True)
上传并嵌入图像
upload_image_and_embed(page_id="123456", filename="arch.png", image_base64="...", replace_url="https://old-host.com/arch.png")
发展
uv sync --extra dev
uv run pytest --cov=confluence_mcp --cov-report=term-missing
许可证
麻省理工学院
