MCP服务器实验平台

一个基于TypeScript的MCP服务器实验平台,用于学习和测试与Calude Desktop和Cursor IDE的集成。

  • by psaboia
  • JavaScript
  • 本地部署
  • 7 星标
  • 更新于
在 GitHub 查看 psaboia/mcp-server-playground

使用说明

MCP服务器游乐场

这个存储库是一个试验用TypeScript构建的MCP服务器的游乐场。这是关于构建MCP服务器的教程和视频的个性化版本,它既是学习资源,也是测试与Calude Desktop和Cursor IDE集成的平台。

背景

本项目基于以下材料:

最初的教程提供了我扩展的基础。除了教程中的示例外,我还计划添加其他工具和功能,将此代码发展成为MCP服务器实验的强大游乐场。

特性

  • 基于TypeScript的服务器: 利用TypeScript实现更好的结构和错误检查。
  • 模块化设计: 易于通过新命令、功能和集成进行扩展。
  • 集成就绪: 设计用于与Calude Desktop和Cursor IDE配合使用,以改善开发体验。
  • 可扩展游乐场: 沙盒环境,用于实验教程示例之外的其他工具和修改。

入门指南

先决条件

  • Node.js(v12或更高版本)
  • npm(或Yarn,根据您的喜好)
  • TypeScript(如果未全局安装)

通过Smithery安装

通过以下方式自动安装Claude Desktop的MCP服务器游乐场 史密瑟里:

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/                # Source code directory
│   └── index.ts       # Main server implementation
├── build/             # Compiled JavaScript files
├── package.json       # Project dependencies and scripts
├── tsconfig.json     # TypeScript configuration
└── README.md         # Project documentation

可用脚本

  • npm run build -编译TypeScript代码并设置适当的权限
  • npm run prepare -运行构建脚本(对git挂钩有用)
  • npm run watch -监视TypeScript文件的更改
  • npm run inspector -运行MCP检查器工具

贡献

欢迎投稿!如果您有建议、改进或新的集成,请分叉存储库并使用您的更改创建拉取请求。

参考文献

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

备注

该项目是一个沙盒环境,旨在测试MCP服务器的各种适应和集成。随着新工具和新想法的开发,将进行更新和扩展。

路线图

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