MCP服务器游乐场
项目介绍
MCP Server Playground
此仓库是一个用于实验使用TypeScript构建的MCP服务器的游乐场。它是教程和视频《构建你的第一个MCP服务器》的个性化版本，旨在作为学习资源以及测试与Calude桌面和Cursor IDE集成的平台。
背景
本项目基于以下材料：
原始教程提供了一个基础，我在此基础上进行了扩展。除了教程中的示例外，我还计划添加额外的工具和功能，以将此代码发展成一个强大的MCP服务器实验游乐场。
特性
- 基于TypeScript的服务器： 利用TypeScript进行更好的结构化和错误检查。
- 模块化设计： 容易扩展新的命令、功能和集成。
- 集成准备就绪： 设计为与Calude桌面和Cursor IDE配合工作，以改善开发体验。
- 可扩展的游乐场： 一个沙盒环境，可以在此环境中试验超出教程示例的额外工具和修改。
开始使用
预备条件
- Node.js（v12或更高）
- npm（或Yarn，根据您的偏好）
- TypeScript（如果未全局安装）
通过Smithery安装
要通过Smithery自动安装MCP Server Playground到Claude桌面：
npx -y @smithery/cli install mcp-server-playground --client claude
安装
- 克隆仓库：
git clone <repo_url> cd mcp-server-playground - 安装依赖项：
npm install - 构建项目：
npm run build
配置
该项目使用环境变量。创建一个.env文件来设置您的配置选项。如果将来提供了示例文件（.env.example），请将其用作模板。
开发
- IDE集成：
- 设计为与Cursor IDE和Calude桌面顺畅工作。
- 利用这些IDE支持的内置工具和扩展以提高生产力。
- 扩展项目：
- 欢迎添加新命令、集成或修改现有功能。
- 服务器的模块化结构使其易于插入额外的工具和功能。
项目结构
mcp-server-playground/
├── src/ # 源代码目录
│ └── index.ts # 主服务器实现
├── build/ # 编译后的JavaScript文件
├── package.json # 项目依赖项和脚本
├── tsconfig.json # TypeScript配置
└── README.md # 项目文档
可用脚本
npm run build- 编译TypeScript代码并设置正确的权限npm run prepare- 运行构建脚本（适用于git钩子）npm run watch- 监视TypeScript文件的变化npm run inspector- 运行MCP检查器工具
贡献
欢迎贡献！如果您有建议、改进或新的集成，请分叉仓库并在您的更改上创建拉取请求。
参考资料
许可证
本项目采用MIT许可证 - 详情见LICENSE文件。
备注
此项目是一个沙盒环境，旨在测试各种适应性和MCP服务器的集成。随着新工具和想法的发展，将会进行更新和扩展。
发展路线图
- 实现超出教程示例的额外工具集成
- 为每个工具添加全面的文档
- 创建与Calude桌面的示例集成
- 开发用于Cursor IDE集成的自定义工具
- 添加测试框架和示例