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