MCP Server Playground

MCP Server Playground

此代码仓库是一个用于试验以 TypeScript 构建的 MCP 服务的 Playground。它是 MCP 服务构建教程和视频的个性化版本，既可作为学习资源，也可用于测试与 Calude Desktop 和 Cursor IDE 的集成。

背景

本项目基于以下资料：

• Build your first MCP Server with TypeScript in Under 10 Minutes
• MCP Server Tutorial Video

原始教程奠定了基础，我在此基础上进行了扩展。除了教程中的示例，我还计划添加更多工具和功能，将此代码发展为一个用于 MCP 服务实验的完善 Playground。

功能

• 基于 TypeScript 的服务： 利用 TypeScript 改善代码结构并进行错误检查。
• 模块化设计： 便于通过新命令、功能和集成进行扩展。
• 支持集成： 专为与 Calude Desktop 和 Cursor IDE 配合使用而设计，以改善开发体验。
• 可扩展的 Playground： 提供沙盒环境，可在教程示例之外试验更多工具和修改。

开始使用

前提条件

• Node.js（v12 或更高版本）
• npm（或根据个人偏好使用 Yarn）
• TypeScript（如果尚未全局安装）

通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装 MCP Server Playground：

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

可用脚本

• npm run build - 编译 TypeScript 代码并设置正确的权限
• npm run prepare - 运行构建脚本（适用于 git hooks）
• npm run watch - 监视 TypeScript 文件的更改
• npm run inspector - 运行 MCP inspector 工具

贡献

欢迎贡献！如果你有任何建议、改进或新的集成，请 fork 此代码仓库，并提交包含相关更改的 pull request。

参考资料

• Build your first MCP Server with TypeScript in Under 10 Minutes
• MCP Server Tutorial Video
• Model Context Protocol SDK Documentation

许可证

本项目采用 MIT 许可证，详情请参阅 LICENSE 文件。

备注

本项目是一个沙盒环境，旨在测试 MCP 服务的各种改编和集成。随着新工具和想法不断涌现，我们将持续更新和扩展。

路线图

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