🚀 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支持团队。