cloudflare markdown mcp服务器
Cloudflare AI的 Markdown变换API 是可以从Claude Code·Codex等AI代理经由MCP(Model Context Protocol)使用的服务器。
在Cloudflare Workers上运行。
一键部署
部署后,请设置以下密码:```bash
npx wrangler secret put CLOUDFLARE_ACCOUNT_ID # Cloudflare アカウント ID
npx wrangler secret put CLOUDFLARE_API_TOKEN # Workers AI 権限付き API トークン
> **如何创建API Token**: Cloudflare API代币 → 自定义令牌→ `Workers AI: Run` 授予权限
## MCP端点```
https://cloudflare-markdown-mcp-server.0g0.xyz/mcp
交付工具
工具名称|说明|
| convert_file_to_markdown 将PDF、Word、Excel、HTML、图像等转换为Markdown
| convert_url_to_markdown 将URL的页面内容转换为Markdown
| list_supported_formats 获取转换支持格式列表
对应文件格式
|类别|扩展名|
文档 .pdf |
Web · .html, .htm, .xml
数据 .csv |
Word · .docx
Excel · .xlsx, .xlsm, .xlsb, .xls, .et
开放文档 · .odt, .ods
苹果 .numbers |
画像 · .jpg, .jpeg, .png, .webp, .svg
安装,安装
需要的东西
- devbox (
curl -fsSL https://get.jetify.com/devbox | bash) - Cloudflare账户(登録)
- Cloudflare API代币(作成方法)
安装```bash
git clone https://github.com/g-kari/-cloudflare-markdown-mcp-server.git
cd cloudflare-markdown-mcp-server
make install
### 设置环境变量
用于本地开发 `.dev.vars` 创建:```bash
cp .dev.vars.example .dev.vars
# .dev.vars を編集して CLOUDFLARE_ACCOUNT_ID と CLOUDFLARE_API_TOKEN を設定
本地启动```bash
make start
http://localhost:8788 で起動
## 部署```bash
# Cloudflare にログイン
npx wrangler login
# シークレット設定
make secret-account-id # CLOUDFLARE_ACCOUNT_ID を入力
make secret-api-token # CLOUDFLARE_API_TOKEN を入力
# デプロイ
make deploy
认证(可选)
API_SECRET 来定义自定义外观 /mcp 和 /api/* 中所述修改相应参数的值。未设置时无认证。
标记发行```bash
openssl(推奨)
openssl rand -hex 32
Node.js
node -e "console.log(require('crypto').randomBytes(32).toString('hex'))"
Python
python3 -c "import secrets; print(secrets.token_hex(32))"
### 配置生产环境```bash
npx wrangler secret put API_SECRET
# → 上で生成したトークンを入力
设置为本地环境
.dev.vars 添加:```
API_SECRET=<生成したトークン>
## 连接AI代理
### Claude Code(单衬垫)
无认证:```bash
claude mcp add cloudflare-markdown \
-- npx mcp-remote https://cloudflare-markdown-mcp-server.0g0.xyz/mcp
已认证:```bash
claude mcp add cloudflare-markdown \
-- npx mcp-remote https://cloudflare-markdown-mcp-server.0g0.xyz/mcp \
--header "Authorization: Bearer "
追加后、`/mcp` 命令显示三个工具。
要删除:```bash
claude mcp remove cloudflare-markdown
最终 ~/.claude.json 的,之 mcpServers 如下所示:```json
{
"cloudflare-markdown": {
"type": "stdio",
"command": "npx",
"args": [
"mcp-remote",
"https://cloudflare-markdown-mcp-server.0g0.xyz/mcp",
"--header",
"Authorization: Bearer "
]
}
}
### 连接到本地服务器时```bash
claude mcp add cloudflare-markdown \
-- npx mcp-remote http://localhost:8788/mcp \
--header "Authorization: Bearer "
开发指令```bash
make help # コマンド一覧表示
make install # 依存パッケージインストール
make start # ローカル開発サーバー起動
make build # TypeScript 型チェック
make deploy # Cloudflare Workers にデプロイ
make logs # Worker ログをリアルタイム確認
make inspector # MCP Inspector でツールをテスト
make secret-list # 設定済みシークレット一覧
## 创建API Token
1. Cloudflare API代币 访问
1. 选择“创建到”→“自定义到”
1. 授予以下权限:
- `Workers AI` --快跑
- `Workers Scripts` --编辑
1. 生成并复制标记
## 项目结构```
cloudflare-markdown-mcp-server/
├── .claude/
│ └── agents/ # Claude Code サブエージェント定義
│ ├── project-manager.md
│ ├── mcp-developer.md
│ ├── api-integrator.md
│ ├── tester.md
│ └── deployer.md
├── src/
│ ├── index.ts # Worker エントリポイント
│ └── mcp.ts # MCP ツール実装 (MarkdownMCP クラス)
├── .dev.vars.example # 環境変数テンプレート
├── devbox.json # 開発環境定義
├── Makefile # コマンド集約
├── wrangler.jsonc # Cloudflare Workers 設定
├── package.json
└── tsconfig.json
许可证
麻省理工学院
