AI导哈

模型上下文协议测试服务器

一个高性能、轻量级的模型上下文协议（MCP）测试服务器，用于实现可由AI模型（如Claude、Gemini等）和集成开发环境（如VS Code和Cursor）使用的MCP工具。

  • by Arav-Menon
  • TypeScript
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 Arav-Menon/mcp-playground

使用说明

🚀 MCP测试服务器

一个高性能、轻量级的模型上下文协议（MCP）服务器，由以下组件构建 包子 和那个 MCP-SDK该项目是实现MCP工具的测试场，这些工具可以被AI模型（如Claude、Gemini等）使用，并集成到VS Code和Cursor等IDE中。

🌟 特性

  • 用Bun建造：利用最快的JavaScript运行时实现最小延迟。
  • MCP SDK v1.29.0：完全符合最新的模型上下文协议规范。
  • 类型安全工具：用途 zod 用于稳健的输入验证。
  • 持久化存储：包括一个演示“数据库”（基于JSON），用于演示有状态的工具交互。
  • 原生VS代码支持：已为MCP VS Code扩展进行了预配置。

🛠 提供的工具

工具名称 描述 输入
add-two-numbers 执行基本算术。 a （数字）， b （编号）
create-user 通过保存到本地JSON文件来模拟用户注册。 name, username, email

📋 先决条件

  • 包子 安装在您的系统上。a
  • MCP兼容客户端（例如，带有MCP扩展的VS Code、Claude Desktop或Cursor）。

🚀 入门指南

1.安装依赖项

bun install

2.运行服务器

服务器使用标准输入/输出（stdio）进行通信：

bun start

3.检查和调试

使用官方的MCP检查器在web界面中测试您的工具：

npm run server:inspect

⚙️ 配置

VS代码集成

该项目包括 .vscode/mcp.json 文件。如果安装了MCP扩展，则可以将其指向此配置以自动加载服务器。

手动MCP客户端设置

要将此服务器添加到像Claude Desktop这样的MCP客户端，请将以下内容添加到配置文件中（通常 ~/Library/Application Support/Claude/claude_desktop_config.json 在macOS或 %APPDATA%\Claude\claude_desktop_config.json 在Windows上）：

{
  "mcpServers": {
    "mcp-testing": {
      "command": "/path/to/bun",
      "args": ["run", "index.ts"],
      "cwd": "/path/to/mcp-testing"
    }
  }
}

📂 项目结构

  • index.ts：初始化MCP服务器和定义工具的主要入口点。
  • data/users.json：本地JSON存储 create-user 工具。
  • .vscode/mcp.json：VS代码MCP扩展的配置。

🧪 发展

如果要添加新工具：

  1. 打开 index.ts.
  2. 使用 server.tool() 定义工具名称、描述和模式。
  3. 使用 zod 用于输入验证。
  4. 重新启动服务器或使用监视模式工具。

建于❤️ 对于AI生态系统来说。

相关 MCP