Psaboia MCP Server Example

🚀 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：提供一个沙箱环境，用于实验工具和修改，超越教程示例。

📦 安装指南

先决条件

需准备 Node.js (v12 或更高版本)、npm（或 Yarn）以及 TypeScript（若未全局安装）。

安装步骤

通过 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

💻 使用示例

基础用法

以下是启动服务器的基本步骤：

git clone <repo_url>
cd mcp-server
npm install
npm run build
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：运行测试。

🔧 技术细节

该项目基于以下材料进行开发：

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

原始教程提供了基础，在此基础上进行了扩展，计划添加更多工具和功能，使代码演变为强大的 playground 用于 MCP 服务器实验。

📄 许可证

项目许可证

备注

该项目旨在为 MCP 服务器的实验和学习提供一个灵活且强大的环境。期望通过社区的努力，不断改进和扩展其功能。欢迎贡献！请查看 CONTRIBUTING.md 获取更多信息。