MCP Typescript Tools Server

🚀 MCP TypeScript 工具服务器

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