AI导哈

Markdown转Confluence转换器

一个将Markdown文件自动转换为Confluence格式并上传的工具，支持Mermaid图表、代码块和图片的转换与上传。

  • by Gyeom
  • JavaScript
  • 本地部署
  • 15 星标
  • 更新于
在 GitHub 查看 Gyeom/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"

空格键格式

类型 格式 示例
全局空格 短键 TEAM, EN, PROD
个人空间 ~ +ID ~712020170fdaa4716743419285f156aa587665

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

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

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

工具

工具 说明
upload_page 从Markdown创建新的Confluence页面
update_page 更新现有页面
create_child_page 在现有页面下创建新页面
sync_file 将本地文件同步到现有页面
list_spaces 列出可用空间
search_pages 搜索页面

运作原理

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. 附加 -上传图片作为页面附件

环境变量

变量 必填 描述
CONFLUENCE_URL ✅ 例如。， https://your-domain.atlassian.net/wiki
CONFLUENCE_EMAIL ✅ 您的Atlassian帐户电子邮件
CONFLUENCE_TOKEN ✅ API令牌

发展

# 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

许可证

麻省理工学院

学分

相关 MCP