MCP Server Playground

<a href="https://glama.ai/mcp/servers/fylny5odo3"> <img width="380" height="200" src="https://glama.ai/mcp/servers/fylny5odo3/badge" alt="Server Playground MCP server" /> </a>

这个仓库是一个使用 TypeScript 构建的 MCP Server 的实验场所。它是关于构建 MCP Server 的教程和视频的个性化版本，旨在作为学习资源和测试与 Calude Desktop 和 Cursor IDE 集成的平台。

背景

本项目基于以下材料：

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

原始教程提供了一个基础，我在此基础上进行了扩展。除了教程中的示例之外，我计划添加额外的工具和功能，将此代码发展成为一个强大的 MCP Server 实验场所。

特性

• 基于 TypeScript 的服务器： 利用 TypeScript 实现更好的结构和错误检查。
• 模块化设计： 易于扩展新的命令、特性和集成。
• 集成就绪： 旨在与 Calude Desktop 和 Cursor IDE 协同工作，以改善开发体验。
• 可扩展的实验场所： 一个沙箱环境，用于试验教程示例之外的额外工具和修改。

开始使用

前提条件

• 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/                # 源代码目录
│   └── index.ts       # 主要服务器实现
├── build/             # 编译后的 JavaScript 文件
├── package.json       # 项目依赖项和脚本
├── tsconfig.json     # TypeScript 配置
└── README.md         # 项目文档

可用脚本

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

贡献

欢迎贡献！如果您有建议、改进或新的集成，请 fork 仓库并创建一个包含您的更改的 pull request。

参考

• 在 10 分钟内使用 TypeScript 构建你的第一个 MCP Server
• MCP Server 教程视频
• Model Context Protocol SDK 文档

许可证

本项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。

备注

本项目是一个沙箱环境，旨在测试 MCP Server 的各种改编和集成。随着新工具和想法的开发，将进行更新和扩展。

路线图

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