MCP Server Playground

🚀 MCP 服务器游乐场

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

🚀 快速开始

前置条件

• Node.js（v12 或更高版本）
• npm（或 Yarn，根据个人偏好）
• TypeScript（若未全局安装）

通过 Smithery 安装

要通过 Smithery 自动安装 MCP 服务器游乐场以供 Claude 桌面版使用，请执行以下命令：

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），可将其用作模板。

✨ 主要特性

• 基于 TypeScript 的服务器：使用 TypeScript 提供更好的结构和错误检查。
• 模块化设计：便于轻松扩展新的命令、功能和集成。
• 集成就绪：设计用于与 Calude 桌面版和 Cursor IDE 集成，以提高开发体验。
• 可扩展的游乐场：提供一个沙盒环境，用于实验工具和修改，超越教程示例。

📦 安装指南

前置要求

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

通过 Smithery 安装

要通过 Smithery 自动安装 MCP 服务器游乐场以供 Claude 桌面版使用：

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），请将其用作模板。

💻 使用示例

基础用法

目前文档未提供基础用法的代码示例。

高级用法

目前文档未提供高级用法的代码示例。

📚 详细文档

背景

该项目基于以下材料：

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

原始教程提供了一个基础，开发者在此基础上进行了扩展。除了教程中的示例之外，还计划添加其他工具和功能，使代码发展成为一个稳健的游乐场，用于 MCP 服务器实验。

开发相关

• 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 检查工具

贡献说明

欢迎贡献！如果你有任何建议、改进或新的整合，请 fork 该仓库并在你的更改中创建 pull request。

参考资料

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