# mcp-md2poster

这是一个基于 [FastMCP](https://github.com/fastmcp/fastmcp) 框架构建的 MCP (Model Context Protocol) 工具包。

## 功能

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

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

## 部署 MCP

```JSON
{
  "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 的值

## 安装依赖

```bash
bun install
```

## 运行项目

```bash
bun run dev
```

## 调试项目

```bash
bun run inspect
```

## 构建项目

```bash
bun run build
```

## 项目结构

- [index.ts](file:///Volumes/SSD/_work/resend-mcp/index.ts): 主入口文件，初始化并启动 FastMCP 服务器
- [tools/add.ts](file:///Volumes/SSD/_work/resend-mcp/tools/add.ts): 实现了 `add` 工具，支持两个数字相加操作
- [utils/logger.ts](file:///Volumes/SSD/_work/resend-mcp/utils/logger.ts): 日志工具模块

## 技术栈

- [Bun](https://bun.sh) - JavaScript/TypeScript 运行时
- [FastMCP](https://github.com/fastmcp/fastmcp) - MCP 框架
- [Zod](https://zod.dev) - TypeScript-first schema declaration and validation library

---

此项目使用 bun v1.2.19 创建。[Bun](https://bun.com) 是一个快速的一体化 JavaScript 运行时。