MCP 服务器到 Markdown

English |简体中文

强大的模型上下文协议 (MCP) 服务器，利用 Cloudflare AI 服务将各种文件格式转换为 Markdown 描述。该服务器提供标准化接口，可实现无缝的文件转换和描述生成。

主要特点

• 与 Cloudflare AI 服务无缝集成

• 高效的 Markdown 描述生成

• 全面的文件格式支持

• 原生 Cloudflare tomarkdown API 集成

• 用户友好的 MCP 界面

• 跨平台兼容性

Related MCP server: Markdownify MCP Server - UTF-8 Enhanced

支持的文件格式

系统要求

• Node.js 18 或更高版本

• 有效的 Cloudflare API 令牌

• 有效的 Cloudflare 帐户 ID

安装

通过 Smithery 安装

要通过Smithery自动为 Claude Desktop 安装 Markdown 转换服务器：

npx -y @smithery/cli install @FradSer/mcp-server-to-markdown --client claude

手动安装

使用 npm 全局安装：

npm install -g mcp-server-to-markdown

MCP 客户端配置

光标集成

1. 导航至光标设置

2. 从侧边栏中选择“MCP”

3. 选择“添加新的全局 MCP 服务器”

4. 应用以下配置：

   {
     "mcpServers": {
       "to-markdown": {
         "command": "mcp-server-to-markdown",
         "args": [
           "CLOUDFLARE_API_TOKEN": "your_api_token"
           "CLOUDFLARE_ACCOUNT_ID": "your_account_id"
         ]
       }
     }
   }

Claude 桌面设置

将以下内容添加到您的claude_desktop_config.json中：

{
  "mcpServers": {
    "to-markdown": {
      "command": "mcp-server-to-markdown",
      "args": [
            "CLOUDFLARE_API_TOKEN": "your_api_token"
            "CLOUDFLARE_ACCOUNT_ID": "your_account_id"
          ]
    }
  }
}

ChatWise 配置

1. 启动 ChatWise

2. 访问设置

3. 选择“工具”部分

4. 点击“+”添加新工具

5. 使用以下参数进行配置：

   • 类型： stdio

   • ID： to-markdown

   • 命令： mcp-server-to-markdown

   • 参数：

     CLOUDFLARE_API_TOKEN=your_api_token
     CLOUDFLARE_ACCOUNT_ID=your_account_id

API 参考

to-markdown 工具

将各种文件格式转换为Markdown描述。

输入参数：

• filePaths ：Array（必需） - 要处理的文件路径列表

响应结构：

[
  {
    "filename": "example.pdf",
    "mimeType": "application/pdf",
    "description": "Generated Markdown description",
    "tokens": 123
  }
]

开发指南

入门

1. 克隆和设置环境：

git clone <repository-url>
cd mcp-server-to-markdown
cp .env.example .env

2. 配置 Cloudflare 凭据：

CLOUDFLARE_API_TOKEN=your_api_token
CLOUDFLARE_ACCOUNT_ID=your_account_id

3. 安装依赖项并构建：

npm install
npm run build

项目结构

.
├── src/             # Source code
├── dist/            # Compiled output
├── types.ts         # Type definitions
└── .env             # Environment configuration

可用脚本

• npm run build - 构建 TypeScript 代码

• npm run inspect - 使用 MCP 检查器运行

使用示例

const result = await toMarkdown({
  filePaths: [
    "/path/to/document.pdf",
    "/path/to/image.jpg"
  ]
});

执照

MIT 许可证

该项目由Frad LEE维护