Md2confluence MCP

md2汇流mcp

Markdown到Confluence转换器 --MCP服务器，将Markdown文件上传到Atlassian Confluence，其中包含自动转换的Mermaid图、代码块和图像。

演示

上传中 showcase.md 与图像和美人鱼图融合

特性

• ✅ 美人鱼图 → PNG（通过kroki.io自动转换）
• ✅ 代码块 → Confluence代码宏
• ✅ 图像 → 附件（自动上传）
• ✅ 表格、链接、格式 → 保存的

安装

克劳德代码

添加到您的克劳德代码设置(~/.claude/settings.json):

{
  "mcpServers": {
    "confluence": {
      "command": "npx",
      "args": ["-y", "md2confluence-mcp"],
      "env": {
        "CONFLUENCE_URL": "https://your-domain.atlassian.net/wiki",
        "CONFLUENCE_EMAIL": "your@email.com",
        "CONFLUENCE_TOKEN": "YOUR_API_TOKEN"
      }
    }
  }
}

项目特定

添加到您的项目 .mcp.json:

{
  "mcpServers": {
    "confluence": {
      "command": "npx",
      "args": ["-y", "md2confluence-mcp"],
      "env": {
        "CONFLUENCE_URL": "https://your-domain.atlassian.net/wiki",
        "CONFLUENCE_EMAIL": "your@email.com",
        "CONFLUENCE_TOKEN": "YOUR_API_TOKEN"
      }
    }
  }
}

获取API令牌

1. 首选https://id.atlassian.com/manage/api-tokens
2. 点击“创建API令牌”
3. 将令牌复制到 CONFLUENCE_TOKEN

用法

配置后，Claude Code可以自动使用这些工具。

提示示例

上传到您的个人空间

"Upload README.md to my personal Confluence space"

"Upload this document to my Confluence space"

上传到特定空间（带URL）

"Upload docs/SETUP.md to Confluence here: https://company.atlassian.net/wiki/spaces/TEAM/overview"

"Create a new page in https://company.atlassian.net/wiki/spaces/~712020170fdaa4716743419285f156aa587665/overview with this content"

更新现有页面

"Update this Confluence page with the latest content: https://company.atlassian.net/wiki/spaces/TEAM/pages/123456/My+Page"

"Sync docs/API.md to https://company.atlassian.net/wiki/spaces/EN/pages/789012/API+Reference"

创建子页面（子页面）

"Create a new page under https://company.atlassian.net/wiki/spaces/TEAM/pages/123456/Parent+Page"

"Add a sub-page to this page: https://company.atlassian.net/wiki/spaces/EN/pages/789012/Guide"

列表和搜索

"Show me available Confluence spaces"

"Find Confluence pages about authentication in the EN space"

空格键格式

提示： 您可以从Confluence URL中提取空格键：

https://company.atlassian.net/wiki/spaces/TEAM/overview
                                        ^^^^ space key

https://company.atlassian.net/wiki/spaces/~712020.../overview
                                        ^^^^^^^^^^ personal space key

工具

运作原理

flowchart LR
    A["Markdown"] --> B["Parse"]
    B --> C["Mermaid → kroki.io → PNG"]
    C --> D["Convert to Confluence HTML"]
    D --> E["Upload via REST API"]
    E --> F["Attach images"]

1. 解析 -提取内容物，去除正面物质
2. 渲染 -通过将Mermaid图转换为PNG kroki.io
3. 转换 -将Markdown转换为Confluence存储格式
4. 上传 -通过Confluence REST API创建/更新页面
5. 附加 -上传图片作为页面附件

环境变量

发展

# Clone
git clone https://github.com/Gyeom/md2confluence-mcp.git
cd md2confluence-mcp

# Install dependencies
npm install

# Build
npm run build

# Test locally
CONFLUENCE_URL=... CONFLUENCE_EMAIL=... CONFLUENCE_TOKEN=... npm start

许可证

麻省理工学院

学分

• kroki.io -图表渲染API
• 模型上下文协议 -MCP-SDK
• Confluence REST API