mcp-md2poster

这是一个基于 FastMCP 框架构建的 MCP (Model Context Protocol) 工具包。

功能

当前实现了一个简单的数学工具：

• add: 用于执行两个数字相加的操作

部署 MCP

{
  "mcpServers": {
    "mcp-md2poster": {
      "args": ["-y","@pidanmoe/mcp-md2poster"],
      "command": "npx",
      "env": {
        "GITHUB_TOKEN": "{{GITHUB_TOKEN}}",
        "GITHUB_OWNER": "{{GITHUB_OWNER}}",
        "GITHUB_REPO": "{{GITHUB_REPO}}",
        "GITHUB_BRANCH": "{{GITHUB_BRANCH}}", // 默认为 main
        "FOLDER": "{{FOLDER}}" // 默认为 uploads
      }
    }
  }
}

使用说明

该项目遵循 Model Context Protocol 规范，可以通过标准 I/O 或其他传输方式与支持 MCP 的客户端进行通信。

工具介绍

add

用于执行两个数字相加的操作

• 必填参数:
  • a: 第一个操作数
  • b: 第二个操作数
• 返回: a + b 的值

安装依赖

bun install

运行项目

bun run dev

调试项目

bun run inspect

构建项目

bun run build

项目结构

• index.ts: 主入口文件，初始化并启动 FastMCP 服务器
• tools/add.ts: 实现了 add 工具，支持两个数字相加操作
• utils/logger.ts: 日志工具模块

技术栈

• Bun - JavaScript/TypeScript 运行时
• FastMCP - MCP 框架
• Zod - TypeScript-first schema declaration and validation library

此项目使用 bun v1.2.19 创建。Bun 是一个快速的一体化 JavaScript 运行时。