md2汇流mcp
Markdown到Confluence转换器 --MCP服务器,将Markdown文件上传到Atlassian Confluence,其中包含自动转换的Mermaid图、代码块和图像。
演示
> 上传中 showcase.md 与图像和美人鱼图融合
特性
- ✅ 美人鱼图 → PNG(通过kroki.io自动转换)
- ✅ 代码块 → Confluence代码宏
- ✅ 图像 → 附件(自动上传)
- ✅ 表格、链接、格式 → 保存的
安装
克劳德代码
添加到您的克劳德代码设置(~/.claude/settings.json):```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`:```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令牌
- 首选https://id.atlassian.com/manage/api-tokens
- 点击“创建API令牌”
- 将令牌复制到
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 |
搜索页面 |
运作原理```mermaid
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. **解析** -提取内容物,去除正面物质
1. **渲染** -通过将Mermaid图转换为PNG kroki.io
1. **转换** -将Markdown转换为Confluence存储格式
1. **上传** -通过Confluence REST API创建/更新页面
1. **附加** -上传图片作为页面附件
## 环境变量
|变量|必填|描述|
|----------|----------|-------------|
| `CONFLUENCE_URL` | ✅ | 例如。, `https://your-domain.atlassian.net/wiki` |
| `CONFLUENCE_EMAIL` | ✅ | 您的Atlassian帐户电子邮件|
| `CONFLUENCE_TOKEN` | ✅ | API令牌|
## 发展```bash
# 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
