MCP服务器开发工具包

一个用于开发、测试和部署模型上下文协议(MCP)服务器的综合工具包,提供生产就绪的服务器模板、测试框架和文档。

  • by james-techyon
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 james-techyon/mcp-server-toolkit

使用说明

MCP服务器工具包

一个用于开发、测试和部署模型上下文协议(MCP)服务器的综合工具包。

🚀 概述

此存储库提供了一个结构化环境,用于创建具有内置测试框架、模板和文档的生产就绪MCP服务器。

📁 目录结构

mcp-server-toolkit/
├── servers/                    # Production-ready MCP servers
│   └── applescript/           # AppleScript execution server
├── testing/                    # Centralized testing framework
│   ├── framework/             # Core test utilities
│   ├── suites/               # Test suites per server
│   └── results/              # Test results (gitignored)
├── development/               # Active development/prototypes
├── templates/                 # Boilerplate for new servers
│   ├── node-mcp-template/    # Node.js server template
│   └── python-mcp-template/  # Python server template
├── docs/                      # Documentation
│   ├── guides/               # How-to guides
│   └── api/                  # API documentation
├── tools/                     # Development utilities
└── _archive/                  # Archived/deprecated items

🏗️ 可用服务器

AppleScript MCP服务器

通过MCP协议执行AppleScript命令。启用与macOS应用程序和系统功能的交互。

  • 位置: servers/applescript/
  • 语言:Node.js和Python实现
  • 文档: docs/guides/applescript-permissions-guide.md

🧪 测试

对所有服务器运行测试:

cd testing/framework
node test-runner.js

对特定服务器运行测试:

cd testing/suites/applescript
./permissions-check.sh

📝 创建新的MCP服务器

  1. 从中选择模板 templates/
  2. 复制到 development/ 用于初始工作
  3. 按照模板README进行设置
  4. 移动到 servers/ 当生产准备就绪时

🔧 全局配置

添加到您的 ~/.claude/claude_config.json:

{
  "mcpServers": {
    "applescript": {
      "command": "node",
      "args": ["/path/to/mcp-server-toolkit/servers/applescript/server.js"]
    }
  }
}

📚 文档

🤝 贡献

  1. 开发新的服务器 development/
  2. 在中编写综合测试 testing/suites/
  3. 文档在 docs/
  4. 准备就绪后提交PR servers/

📄 许可证

单个服务器可能有自己的许可证。有关详细信息,请参阅每个服务器的目录。