cloudflare markdown mcp服务器
Cloudflare AI的 Markdown变换API 是可以从Claude Code·Codex等AI代理经由MCP（Model Context Protocol）使用的服务器。
在Cloudflare Workers上运行。
一键部署
部署后，请设置以下密码：
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 |
安装，安装
需要的东西
安装
git clone https://github.com/g-kari/-cloudflare-markdown-mcp-server.git
cd cloudflare-markdown-mcp-server
make install设置环境变量
用于本地开发 .dev.vars 创建：
cp .dev.vars.example .dev.vars
# .dev.vars を編集して CLOUDFLARE_ACCOUNT_ID と CLOUDFLARE_API_TOKEN を設定本地启动
make start
# http://localhost:8788 で起動部署
# Cloudflare にログイン
npx wrangler login
# シークレット設定
make secret-account-id # CLOUDFLARE_ACCOUNT_ID を入力
make secret-api-token # CLOUDFLARE_API_TOKEN を入力
# デプロイ
make deploy认证（可选）
API_SECRET 来定义自定义外观 /mcp 和 /api/* 中所述修改相应参数的值。未设置时无认证。
标记发行
# 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))"配置生产环境
npx wrangler secret put API_SECRET
# → 上で生成したトークンを入力设置为本地环境
.dev.vars 添加：
API_SECRET=连接AI代理
Claude Code（单衬垫）
无认证：
claude mcp add cloudflare-markdown \
-- npx mcp-remote https://cloudflare-markdown-mcp-server.0g0.xyz/mcp已认证：
claude mcp add cloudflare-markdown \
-- npx mcp-remote https://cloudflare-markdown-mcp-server.0g0.xyz/mcp \
--header "Authorization: Bearer "追加后、/mcp 命令显示三个工具。
要删除：
claude mcp remove cloudflare-markdown最终 ~/.claude.json 的，之 mcpServers 如下所示：
{
"cloudflare-markdown": {
"type": "stdio",
"command": "npx",
"args": [
"mcp-remote",
"https://cloudflare-markdown-mcp-server.0g0.xyz/mcp",
"--header",
"Authorization: Bearer "
]
}
}连接到本地服务器时
claude mcp add cloudflare-markdown \
-- npx mcp-remote http://localhost:8788/mcp \
--header "Authorization: Bearer "开发指令
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
- Cloudflare API代币 访问
- 选择“创建到”→“自定义到”
- 授予以下权限：
- Workers AI --快跑 - Workers Scripts --编辑
- 生成并复制标记
项目结构
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许可证
麻省理工学院