🚀 MCP 服务器 playground

此仓库是用于实验使用 TypeScript 构建的 MCP 服务器的 playground。它结合了教程和个人化版本的视频，既可以作为学习资源，也能作为测试与 Calude Desktop 和 Cursor IDE 集成的平台。

🚀 快速开始

先决条件

• Node.js (v12 或更高版本)
• npm（或 Yarn，基于你的偏好）
• TypeScript（如果不是全局安装）

通过 Smithery 安装

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

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

手动安装

1. 克隆仓库：

   git clone <repo_url>
   cd mcp-server
   

2. 安装依赖项：

   npm install
   

3. 构建项目：

   npm run build
   

4. 启动服务器：

   npm start
   

配置

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

✨ 主要特性

• 基于 TypeScript 的服务器：利用 TypeScript 进行更好的结构化和错误检查。
• 模块化设计：易于扩展新的命令、功能和集成。
• 集成就绪：设计为与 Calude Desktop 和 Cursor IDE 一起工作，以实现更高效的开发体验。
• 可扩展的 playground：一个沙箱环境，用于实验工具和修改，超越教程示例。

📦 安装指南

安装步骤

通过 Smithery 自动安装

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

手动克隆与安装

git clone <repo_url>
cd mcp-server
npm install
npm run build
npm start

💻 使用示例

基础用法

在完成安装和配置后，你可以使用以下命令启动服务器：

npm start

📚 详细文档

开发

• IDE 集成：
  • 设计为与 Cursor IDE 和 Calude Desktop 平滑工作。
  • 利用这些 IDE 支持的内置工具和扩展，以最大化生产力。
• 扩展项目：
  • 欢迎自由添加新的命令、集成或修改现有功能。
  • 服务器的模块化结构使其易于插入新的工具和功能。

项目结构

mcp-server/
├── src/                # 源代码目录
│   └── index.ts       # 主服务器实现
├── build/             # 编译后的 JavaScript 文件
├── package.json       # 项目依赖项和脚本
├── tsconfig.json     # TypeScript 配置
└── README.md          # 说明文件

可用脚本

• npm run build：构建项目。
• npm run start：启动服务器。
• npm run test：运行测试。

贡献

欢迎贡献！请查看 CONTRIBUTING.md 以获取更多信息。

参考文献

• 从零开始构建你的第一个MCP服务器（用 TypeScript 下于10分钟）
• MCP 服务器教程视频

📄 许可证

项目许可证

备注

该项目旨在为 MCP 服务器的实验和学习提供一个灵活且强大的环境。通过社区的努力，我们希望不断改进和扩展其功能。