MCP Starter

🚀 MCP 啟動服務器

MCP 啟動服務器是一個用於構建 AI 助手工具的最小 模型上下文協議 服務器模板。它為創建與 AI 助手（如Claude）兼容的 MCP 工具提供了基本結構，能幫助開發者快速搭建相關項目。

🚀 快速開始

如果你想讓 MCP 啟動服務器與Claude協同工作，可按以下步驟操作：

1. 下載並安裝 Claude Desktop 應用
2. 克隆倉庫，安裝依賴項並構建：

npm install
npm run build

3. 配置 Claude 使用此 MCP 服務器。如果是你的第一個 MCP 服務器，請在項目根目錄運行：

echo '{
  "mcpServers": {
    "mcp-starter": {
      "command": "node",
      "args": ["'$PWD'/dist/index.cjs"]
    }
  }
}' > ~/Library/Application\ Support/Claude/claude_desktop_config.json

這將在你的 claude_desktop_config.json 中添加如下內容：

"mcpServers": {
  "mcp-starter": {
    "command": "node",
    "args": ["/Users/matt/code/mcp-starter/dist/index.cjs"]
  }
}

如果你已經擁有其他 MCP 服務器，請將 mcp-starter 塊添加到現有配置中。重要的是，args 是路徑 /path_to_repo_on_your_machine/mcp-starter/dist/index.cjs。 4. 重啟 Claude Desktop 應用。 5. 在 Claude 的界面中查找錘子圖標並確認服務器運行正常。 6. 如果一切正常，你可以使用 npm run dev 進行開發並在 Claude 中測試。每次需要重新啟動 MCP 服務器時都需要重新啟動 Claude。

✨ 主要特性

• 提供簡單的 "你好，世界" 工具示例，方便開發者快速上手。
• 採用 TypeScript + esbuild 設置，提升開發效率和代碼質量。
• 開發工具預配置，節省開發者的配置時間。

💻 使用示例

基礎用法

使用 Inspector 開發

為了開發和調試目的，你可以使用 MCP 檢查器工具。檢查器提供了一個可視界面用於測試和監控 MCP 服務器交互。 訪問 Inspector 文檔 獲取詳細設置說明。 要本地測試：

npm run inspect

在文件更改時構建：

npm run watch

或者同時運行觀察者和檢查器：

npm run dev

高級用法

發佈服務器

準備好分發服務器後，步驟很簡單：

1. 設置一個 NPM 賬戶。
2. 運行 npm publish。這將使用 package.json 中的項目名稱發佈包。
3. 一旦發佈，其他人可以通過配置條目安裝你的服務器：

"mcpServers": {
  "<your-package-name>": {
    "command": "npx",
    "args": ["<your-package-name>"]
  }
}

📚 詳細文檔

可用工具

服務器提供以下工具：

• hello_tool：一個簡單的示例工具，帶有一個名稱參數並返回問候語。

創建新工具

要添加新的工具，可按以下步驟操作：

1. 在 index.ts 中定義工具模式。
2. 將其添加到 ListToolsRequestSchema 處理器的工具數組中。
3. 在 CallToolRequestSchema 處理器中添加其實現。 你可以查看 hello_tool 的實現作為示例。