MCP 服务器游乐场

这个仓库是一个用于实验用 TypeScript 构建的 MCP 服务器的游乐场。它是基于构建 MCP 服务器教程和个人化版本的视频，旨在既作为一个学习资源，也是一个测试与 Calude Desktop 和 Cursor IDE 集成的平台。

背景

这个项目基于以下材料：

• 在10分钟内用 TypeScript 构建你的第一个 MCP 服务器
• MCP 服务器教程视频

原始教程提供了一个基础，我在此基础上进行了扩展。除了教程中的示例之外，我还计划添加额外的工具和功能，将这段代码演变成一个强大的 MCP 服务器实验游乐场。

特性

• 基于 TypeScript 的服务器： 利用 TypeScript 提供更好的结构和错误检查。
• 模块化设计： 可以轻松地通过新的命令、特性和集成进行扩展。
• 即插即用的集成： 设计为与 Calude Desktop 和 Cursor IDE 无缝工作，以提高开发体验。
• 可扩展的游乐场： 一个沙盒环境，用于尝试超出教程示例外的附加工具和修改。

开始使用

前提条件

• Node.js (v12 或更高版本)
• npm (或 Yarn，根据您的偏好)
• TypeScript（如果未全局安装）

通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装 MCP 服务器游乐场：

npx -y @smithery/cli install mcp-server-playground --client claude

安装

1. 克隆仓库：

   git clone <repo_url>
   cd mcp-server-playground
   

2. 安装依赖项：

   npm install
   

3. 构建项目：

   npm run build
   

配置

此项目使用环境变量。创建一个 .env 文件来设置您的配置选项。如果未来提供了示例文件（.env.example），请将其作为模板使用。

开发

• IDE 集成：
  • 设计为与 Cursor IDE 和 Calude Desktop 平滑运行。
  • 利用这些 IDE 支持的内置工具和扩展程序以最大化生产力。
• 扩展项目：
  • 您可以自由添加新命令、集成或修改现有功能。
  • 服务器的模块化结构使得插入额外工具和特性变得简单。

项目结构

mcp-server-playground/
├── src/                # Source code directory
│   └── index.ts       # Main server implementation
├── build/             # Compiled JavaScript files
├── package.json       # Project dependencies and scripts
├── tsconfig.json     # TypeScript configuration
└── README.md         # Project documentation

可用脚本

请注意，您提供的 markdown 中有两个代码块标记为 #0 和 #1，这似乎是指向特定内容的占位符。请确保替换这些占位符以反映实际的命令或项目结构信息。

• npm run build - 编译 TypeScript 代码并设置适当的权限
• npm run prepare - 运行构建脚本（对 git 钩子有用）
• npm run watch - 监视 TypeScript 文件的变化
• npm run inspector - 运行 MCP 检查工具

贡献

欢迎贡献！如果您有任何建议、改进或新的集成，请 fork 仓库并在您的更改基础上创建一个拉取请求。

参考资料

• 在10分钟内用TypeScript构建你的第一个MCP服务器
• MCP 服务器教程视频
• 模型上下文协议 SDK 文档

许可证

本项目根据 MIT 许可证发布 - 详情请参阅 LICENSE 文件。

注意事项

该项目是一个沙箱环境，旨在测试各种针对 MCP 服务器的适配和集成。随着新工具和想法的发展，将会进行更新和扩展。

路线图

• 实现超出教程示例之外的额外工具集成
• 为每个工具添加全面的文档
• 创建与 Calude Desktop 的示例集成
• 开发用于 Cursor IDE 集成的自定义工具
• 添加测试框架和示例