Cloudflare Markdown MCP Server

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 |

安装，安装

需要的东西

• devbox (curl -fsSL https://get.jetify.com/devbox | bash)
• Cloudflare账户（登録）
• Cloudflare API代币(作成方法）

安装

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

1. Cloudflare API代币 访问
2. 选择“创建到”→“自定义到”
3. 授予以下权限：

- 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

许可证

麻省理工学院