MCP Typescript Tools Server

🚀 MCP TypeScript 工具服務器

本項目是一個用 TypeScript 實現的 Model Context Protocol (MCP) 服務器，為大型語言模型（如Claude）提供各類實用工具。服務器集成了計算器、日期時間工具和筆記工具，並且採用可擴展架構，方便添加更多實用工具。

🚀 快速開始

本服務器為大型語言模型提供了實用工具，您可按以下步驟完成安裝與配置，即可開始使用。

✨ 主要特性

• 🧮 具備基本數學運算的計算器工具，滿足日常計算需求。
• 📅 支持不同格式的當前日期/時間工具，靈活獲取時間信息。
• 📝 提供文本筆記保存和檢索工具，方便記錄重要信息。
• 🔌 與Claude桌面版和Cursor兼容，可在不同環境中使用。
• 🚀 架構易於擴展，能夠輕鬆添加新工具。

📦 安裝指南

先決條件

• Node.js（v16或更高版本）
• npm（隨Node.js提供）
• Claude 桌面版和/或 Cursor（用於使用工具）

安裝步驟

1. 克隆倉庫：

git clone <your-repo-url>
cd MCP

2. 安裝依賴項：

npm install

3. 構建項目：

npm run build

📚 詳細文檔

與Claude桌面版配置

1. 打開或創建您的Claude桌面配置文件：

   • Windows：%APPDATA%\Claude\claude_desktop_config.json
   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json

2. 添加MCP服務器配置：

{
  "mcpServers": {
    "MCPllmContext": {
      "command": "node",
      "args": [
        "ABSOLUTE_PATH_TO_YOUR_PROJECT/dist/index.js"
      ]
    }
  }
}

請將ABSOLUTE_PATH_TO_YOUR_PROJECT替換為您項目的實際路徑。

3. 重新啟動Claude桌面版。
4. 查找輸入框中的錘子圖標以確認工具已可用。

與Cursor配置

1. 打開Cursor。
2. 轉到 Cursor 設置 > 功能 > MCP。
3. 點擊 + 添加新MCP服務器。
4. 填寫表單：
   • 類型：stdio
   • 名稱：MCPllmContext
   • 命令：node ABSOLUTE_PATH_TO_YOUR_PROJECT/dist/index.js

可用工具

計算器

• 工具名稱：calculate
• 描述：評估數學表達式
• 使用方法：“計算2 + 2”

日期時間

• 工具名稱：current-date
• 描述：返回當前日期/時間
• 格式： "short" 或 "long"
• 使用方法：“今天是什麼日期？”

筆記

• 工具名稱：save-note, get-note, list-notes
• 描述：保存和檢索文本筆記
• 使用方法：“保存一個標題為'Meeting'的筆記，內容為'Discuss project'”

添加新工具

1. 在 src/tools/ 目錄下創建一個新的文件（例如，src/tools/myTool.ts）。
2. 使用以下模板實現您的工具：

import { z } from "zod";
import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";

export function registerMyTools(server: McpServer) {
  server.tool(
    "tool-name",
    { 
      param: z.string().describe("參數描述") 
    },
    async ({ param }) => {
      return {
        content: [{ type: "text", text: "結果" }]
      };
    }
  );
}

3. 在 src/tools/index.ts 中導出您的工具。
4. 在 src/index.ts 中註冊您的工具。

開發

# 構建項目
npm run build

# 直接運行服務器
node dist/index.js

# 監視更改（如果您安裝了nodemon）
nodemon dist/index.js

故障排除

Claude桌面版問題

• 檢查日誌：%APPDATA%\Claude\logs\mcp*.log（Windows）或 ~/Library/Logs/Claude/mcp*.log（macOS）。
• 驗證 claude_desktop_config.json 中的路徑是否為絕對且正確。
• 重新啟動Claude桌面版後重新嘗試。

Cursor問題

• 確保您使用的是最新版本的Cursor。
• 檢查控制檯是否有錯誤信息。
• 如果問題持續，請聯繫Cursor支持團隊。