MCP TypeScript Tools Server

MCP TypeScript 工具服务

使用 TypeScript 实现的模型上下文协议（MCP）服务，为 Claude 等大模型提供各种实用工具。此服务包含计算器、日期时间和笔记工具，并采用可扩展的架构，方便添加更多工具。

功能

• 🧮 用于基本数学运算的计算器工具
• 📅 用于以不同格式获取当前日期和时间的日期时间工具
• 📝 用于保存和检索文本笔记的笔记工具
• 🔌 兼容 Claude for Desktop 和 Cursor
• 🚀 轻松扩展，添加新工具

先决条件

• Node.js（v16 或更高版本）
• npm（随 Node.js 一同安装）
• Claude for Desktop 和/或 Cursor（用于使用这些工具）

安装

1. 克隆代码库：

git clone <your-repo-url>
cd MCP

2. 安装依赖项：

npm install

3. 构建项目：

npm run build

在 Claude for Desktop 中设置

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 for Desktop
4. 查看输入框中的锤子图标，确认工具已可用

在 Cursor 中设置

1. 打开 Cursor
2. 前往 Cursor Settings > Features > MCP
3. 点击 + Add New MCP Server
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("Parameter description") 
    },
    async ({ param }) => {
      return {
        content: [{ type: "text", text: "Result" }]
      };
    }
  );
}

3. 在 src/tools/index.ts 中导出工具
4. 在 src/index.ts 中注册工具

开发

# Build the project
npm run build

# Run the server directly
node dist/index.js

# Watch for changes (if you have nodemon installed)
nodemon dist/index.js

故障排除

Claude for Desktop 问题

• 查看日志：%APPDATA%\Claude\logs\mcp*.log（Windows）或 ~/Library/Logs/Claude/mcp*.log（macOS）
• 确认 claude_desktop_config.json 中的路径是绝对路径且正确无误
• 确保已构建服务（npm run build）
• 更改配置后重启 Claude for Desktop

Cursor 问题

• 确认 Cursor 的 MCP 设置中的命令路径正确
• 尝试在 MCP 设置中刷新工具列表
• 检查 Cursor 的日志是否包含错误消息