MCP Zenon

🚀 MCP 服務器啟動模板

本模板是一個用於構建 Model Context Protocol (MCP) 服務器的生產就緒 starter 模板，採用 TypeScript 編寫，能幫助開發者高效搭建 MCP 服務器。

🚀 快速開始

克隆倉庫

安裝依賴

bun install

✨ 主要特性

• 藉助 Bun 實現快速測試和開發，提升開發效率。
• 利用 Biome 進行代碼檢查和格式化，保證代碼質量。
• 採用 standard - version 實現版本管理自動化，簡化版本管理流程。
• 擁有清晰、易於維護的項目結構，降低開發和維護成本。

📂 項目結構

mcp-starter/
├── src/
│   ├── tools/          # MCP 工具實現
│   ├── utils/          # 公共工具類
│   ├── main.ts         # 服務器入口文件
│   └── types.ts        # 共用類型定義
├── tests/              # 測試文件
├── biome.json          # 代碼檢查配置
├── tsconfig.json       # TypeScript 配置
└── package.json        # 項目依賴管理

⚙️ 配置

創建新工具

該項目提供了一個腳本，可幫助你輕鬆創建新的 MCP 工具：

bun run scripts/create-tool.ts <tool-name>

此命令會執行以下操作：

1. 在 src/tools/<tool-name> 目錄下創建一個新的工具目錄。
2. 生成基本的工具結構，包含：
   • index.ts（主要實現文件）
   • schema.ts（工具參數的 JSON 模式定義）
   • test.ts（測試文件）
3. 更新工具索引文件，以便導出新的工具。

示例：

bun run scripts/create-tool.ts weather

🛠️ 開發

• 運行測試：bun test
• 格式化代碼：bun run format
• 檢查代碼：bun run lint
• 構建項目：bun run build

若要將你的開發 MCP 服務器添加到 Claude Desktop，可按以下步驟操作：

構建項目

bun run build

更新你的 Claude Desktop 配置

// 只需要在需要傳遞參數時包含命令行參數
{
  "mcpServers": {
    "your-server-name": {
      "command": "node",
      "args": ["/path/to/your/project/dist/main.js", "some_argument"]
    }
  }
}

📜 版本管理

該項目使用 standard - version 實現版本管理自動化。運行 bun run release 即可創建新版本。

提交信息格式

• feat：新增功能（遞增次要版本）
• fix：修復問題（遞增補丁版本）
• BREAKING CHANGE：破壞性更改（遞增主版本）

📦 發佈到 npm

確保已登錄 npm

npm login

構建項目

bun run build

發佈包

npm publish

在發佈新版本之前，請使用 bun run release 更新版本號。

📦 從 npm 安裝（發佈後）

將以下內容添加到你的 Claude Desktop 配置中：

// 只需要在需要傳遞參數時包含命令行參數
{
  "mcpServers": {
    "your-server-name": {
      "command": "npx",
      "args": ["-y", "your-package-name", "some_argument"]
    }
  }
}