{"id":51026625,"url":"https://github.com/gitstq/mcp-toolkit-cli","last_synced_at":"2026-06-21T20:02:08.290Z","repository":{"id":362944949,"uuid":"1261390216","full_name":"gitstq/mcp-toolkit-cli","owner":"gitstq","description":"🔧 MCP Toolkit CLI - Lightweight MCP Server Development Toolkit | 轻量级MCP服务器开发工具包 | Zero Dependencies · Multi-Language · One-Command Scaffold","archived":false,"fork":false,"pushed_at":"2026-06-06T16:13:36.000Z","size":20,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-06T18:09:24.173Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gitstq.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-06T16:10:46.000Z","updated_at":"2026-06-06T16:13:19.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/gitstq/mcp-toolkit-cli","commit_stats":null,"previous_names":["gitstq/mcp-toolkit-cli"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/gitstq/mcp-toolkit-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fmcp-toolkit-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fmcp-toolkit-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fmcp-toolkit-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fmcp-toolkit-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gitstq","download_url":"https://codeload.github.com/gitstq/mcp-toolkit-cli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fmcp-toolkit-cli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34623906,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-21T02:00:05.568Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-06-21T20:02:07.530Z","updated_at":"2026-06-21T20:02:08.279Z","avatar_url":"https://github.com/gitstq.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🔧 MCP Toolkit CLI\n\n\u003cdiv align=\"center\"\u003e\n\n[![Python](https://img.shields.io/badge/Python-3.8%2B-blue?logo=python)](https://python.org)\n[![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)\n[![Zero Dependencies](https://img.shields.io/badge/Dependencies-Zero-brightgreen)](#)\n[![MCP](https://img.shields.io/badge/MCP-Protocol-orange)](#)\n\n**🚀 Lightweight MCP Server Development Toolkit | 轻量级 MCP 服务器开发工具包 | 輕量級 MCP 伺服器開發工具包**\n\n[简体中文](#简体中文) | [繁體中文](#繁體中文) | [English](#english)\n\n\u003c/div\u003e\n\n---\n\n## 简体中文\n\n### 🎉 项目介绍\n\n**MCP Toolkit CLI** 是一款专为 [Model Context Protocol (MCP)](https://modelcontextprotocol.io) 设计的轻量级服务器开发工具包。它让开发者能够通过一条命令快速搭建符合 MCP 标准的 AI 工具服务器，无需繁琐的配置和重复劳动。\n\n**灵感来源**：随着 Claude、Cursor、Copilot 等 AI 编码助手生态的爆发，MCP 协议成为连接 AI 与外部工具的标准桥梁。然而，开发一个合规的 MCP 服务器需要处理 JSON-RPC 通信、工具注册、参数校验等复杂逻辑。MCP Toolkit CLI 正是为了解决这一痛点而生——**让 MCP 服务器开发像搭积木一样简单**。\n\n**自研差异化亮点**：\n- 🎯 **零依赖核心**：纯 Python 标准库实现，无需安装任何第三方包\n- 🌐 **多语言支持**：一键生成 Python / TypeScript / JavaScript 项目\n- 📦 **丰富模板**：内置基础、API、数据处理、AI 集成四大模板\n- 🔍 **合规校验器**：自动检测 MCP 协议兼容性，提前发现问题\n- 🐛 **交互式调试器**：内置 stdio 通信测试，一键验证服务器功能\n\n### ✨ 核心特性\n\n| 特性 | 说明 |\n|------|------|\n| ⚡ **一键脚手架** | `mcp-toolkit init my-server` 秒级生成完整项目 |\n| 🈳 **零依赖运行** | 核心功能仅依赖 Python 标准库，部署零负担 |\n| 🔤 **多语言生成** | 支持 Python、TypeScript、JavaScript 三种语言 |\n| 📋 **4 大模板** | Basic / API / Data / AI 覆盖常见场景 |\n| 🛡️ **合规校验** | 7 项自动化检查确保 MCP 协议兼容 |\n| 🐛 **内置调试** | 模拟 MCP 客户端通信，快速定位问题 |\n| 🔧 **可选功能** | 认证、日志、指标、沙箱等插件化扩展 |\n| 🧪 **测试套件** | 自动生成单元测试，保障代码质量 |\n\n### 🚀 快速开始\n\n#### 环境要求\n\n- **Python** \u003e= 3.8\n- 支持平台：Linux / macOS / Windows\n\n#### 安装\n\n```bash\n# 方式一：pip 安装\npip install mcp-toolkit-cli\n\n# 方式二：源码安装\ngit clone https://github.com/gitstq/mcp-toolkit-cli.git\ncd mcp-toolkit-cli\npip install -e .\n```\n\n#### 创建你的第一个 MCP 服务器\n\n```bash\n# 创建一个基础 Python MCP 服务器\nmcp-toolkit init my-first-server --template basic --language python\n\n# 进入项目目录\ncd my-first-server\n\n# 查看生成的文件\nls\n# server.py  mcp_manifest.json  README.md  config.json\n\n# 运行服务器\npython server.py\n```\n\n#### 验证合规性\n\n```bash\n# 检查服务器是否符合 MCP 协议\nmcp-toolkit validate .\n\n# 输出示例：\n# ✅ All checks passed! MCP compliant.\n```\n\n#### 调试服务器\n\n```bash\n# 启动交互式调试，测试 stdio 通信\nmcp-toolkit debug . --verbose\n\n# 输出示例：\n# ✅ Server initialized successfully!\n# 🔧 Available tools (3):\n#    - hello_world: Say hello to the world\n#    - echo: Echo back the input message\n#    - calculator: Perform basic calculations\n```\n\n### 📖 详细使用指南\n\n#### 命令一览\n\n```bash\nmcp-toolkit info              # 显示工具包信息\nmcp-toolkit list-templates    # 列出所有可用模板\nmcp-toolkit init \u003cname\u003e       # 初始化新项目\n  --template, -t    选择模板 (basic/api/data/ai)\n  --language, -l    选择语言 (python/typescript/javascript)\n  --features, -f    附加功能 (auth/logging/metrics/sandbox)\nmcp-toolkit validate [path]   # 验证 MCP 合规性\nmcp-toolkit debug [path]      # 调试服务器\nmcp-toolkit test [path]       # 运行测试套件\n```\n\n#### 高级用法：带认证的 API 服务器\n\n```bash\nmcp-toolkit init my-api-server \\\n  --template api \\\n  --language python \\\n  --features auth logging\n\n# 生成的服务器将包含：\n# - HTTP 客户端工具\n# - Token 认证接口\n# - 日志查询接口\n```\n\n#### 模板说明\n\n| 模板 | 适用场景 | 内置工具 |\n|------|---------|---------|\n| `basic` | 通用工具服务器 | hello_world, echo, calculator |\n| `api` | 外部 API 封装 | http_client, auth, rate_limiting |\n| `data` | 数据处理管道 | csv_parser, json_transform, validator |\n| `ai` | AI/LLM 集成 | prompt_template, chain_builder, model_router |\n\n### 💡 设计思路与迭代规划\n\n**技术选型原因**：\n- 选择 Python 作为核心语言，因其标准库丰富、跨平台兼容性好\n- 零依赖设计确保在任何环境中都能即装即用\n- 模板引擎采用纯代码生成，避免引入 Jinja2 等模板依赖\n\n**后续迭代计划**：\n- [ ] 支持更多语言模板（Go、Rust、Java）\n- [ ] 集成 MCP Inspector 可视化调试\n- [ ] 添加 Docker 打包支持\n- [ ] 支持远程模板仓库（自定义模板）\n- [ ] 集成 CI/CD 工作流生成\n\n**社区贡献方向**：\n- 提交新的服务器模板\n- 完善多语言文档翻译\n- 报告 MCP 协议兼容性 issue\n\n### 📦 打包与部署\n\n```bash\n# 本地打包\npython setup.py sdist bdist_wheel\n\n# 安装到本地\npip install dist/mcp_toolkit_cli-1.0.0-py3-none-any.whl\n\n# 发布到 PyPI（维护者）\npython -m twine upload dist/*\n```\n\n### 🤝 贡献指南\n\n欢迎提交 PR！请遵循以下规范：\n\n1. **代码风格**：遵循 PEP 8，使用 4 空格缩进\n2. **提交信息**：使用 Angular 规范（`feat:` / `fix:` / `docs:` / `refactor:`）\n3. **测试覆盖**：新功能需附带单元测试\n4. **文档同步**：更新对应语言版本的 README\n\n### 📄 开源协议\n\n本项目采用 [MIT License](LICENSE) 开源协议。\n\n---\n\n## 繁體中文\n\n### 🎉 專案介紹\n\n**MCP Toolkit CLI** 是一款專為 [Model Context Protocol (MCP)](https://modelcontextprotocol.io) 設計的輕量級伺服器開發工具包。開發者只需一條指令，即可快速建立符合 MCP 標準的 AI 工具伺服器，省去繁瑣的設定與重複工作。\n\n**自研差異化亮點**：\n- 🎯 **零依賴核心**：純 Python 標準函式庫實作，無需安裝任何第三方套件\n- 🌐 **多語言支援**：一鍵生成 Python / TypeScript / JavaScript 專案\n- 📦 **豐富模板**：內建基礎、API、資料處理、AI 整合四大模板\n- 🔍 **合規校驗器**：自動檢測 MCP 協定相容性，提前發現問題\n- 🐛 **互動式除錯器**：內建 stdio 通訊測試，一鍵驗證伺服器功能\n\n### ✨ 核心特性\n\n| 特性 | 說明 |\n|------|------|\n| ⚡ **一鍵腳手架** | `mcp-toolkit init my-server` 秒級生成完整專案 |\n| 🈳 **零依賴執行** | 核心功能僅依賴 Python 標準函式庫，部署零負擔 |\n| 🔤 **多語言生成** | 支援 Python、TypeScript、JavaScript 三種語言 |\n| 📋 **4 大模板** | Basic / API / Data / AI 覆蓋常見場景 |\n| 🛡️ **合規校驗** | 7 項自動化檢查確保 MCP 協定相容 |\n| 🐛 **內建除錯** | 模擬 MCP 客戶端通訊，快速定位問題 |\n| 🔧 **可選功能** | 認證、日誌、指標、沙箱等外掛化擴充 |\n| 🧪 **測試套件** | 自動生成單元測試，保障程式碼品質 |\n\n### 🚀 快速開始\n\n#### 環境要求\n\n- **Python** \u003e= 3.8\n- 支援平台：Linux / macOS / Windows\n\n#### 安裝\n\n```bash\n# pip 安裝\npip install mcp-toolkit-cli\n```\n\n#### 建立你的第一個 MCP 伺服器\n\n```bash\nmcp-toolkit init my-first-server --template basic --language python\ncd my-first-server\npython server.py\n```\n\n#### 驗證合規性\n\n```bash\nmcp-toolkit validate .\n# ✅ All checks passed! MCP compliant.\n```\n\n### 📖 詳細使用指南\n\n#### 指令一覽\n\n```bash\nmcp-toolkit info              # 顯示工具包資訊\nmcp-toolkit list-templates    # 列出所有可用模板\nmcp-toolkit init \u003cname\u003e       # 初始化新專案\n  --template, -t    選擇模板 (basic/api/data/ai)\n  --language, -l    選擇語言 (python/typescript/javascript)\n  --features, -f    附加功能 (auth/logging/metrics/sandbox)\nmcp-toolkit validate [path]   # 驗證 MCP 合規性\nmcp-toolkit debug [path]      # 除錯伺服器\nmcp-toolkit test [path]       # 執行測試套件\n```\n\n### 💡 設計思路與迭代規劃\n\n**技術選型原因**：選擇 Python 作為核心語言，因其標準函式庫豐富、跨平台相容性佳。零依賴設計確保在任何環境中都能即裝即用。\n\n**後續迭代計畫**：\n- [ ] 支援更多語言模板（Go、Rust、Java）\n- [ ] 整合 MCP Inspector 視覺化除錯\n- [ ] 新增 Docker 打包支援\n- [ ] 支援遠端模板倉庫\n\n### 🤝 貢獻指南\n\n歡迎提交 PR！請遵循 Angular 提交規範（`feat:` / `fix:` / `docs:` / `refactor:`）。\n\n### 📄 開源協議\n\n本專案採用 [MIT License](LICENSE) 開源協議。\n\n---\n\n## English\n\n### 🎉 Project Introduction\n\n**MCP Toolkit CLI** is a lightweight development toolkit for [Model Context Protocol (MCP)](https://modelcontextprotocol.io) servers. It enables developers to scaffold MCP-compliant AI tool servers with a single command—no tedious configuration or repetitive work required.\n\n**Inspiration**: As AI coding assistants like Claude, Cursor, and Copilot explode in popularity, MCP has become the standard bridge connecting AI to external tools. However, building a compliant MCP server involves complex JSON-RPC communication, tool registration, parameter validation, and more. MCP Toolkit CLI was born to solve this pain point—**making MCP server development as easy as building with blocks**.\n\n**Key Differentiators**:\n- 🎯 **Zero-dependency core**: Pure Python standard library, no third-party packages needed\n- 🌐 **Multi-language support**: Generate Python / TypeScript / JavaScript projects in one click\n- 📦 **Rich templates**: Built-in Basic, API, Data, and AI integration templates\n- 🔍 **Compliance validator**: Auto-detect MCP protocol compatibility issues\n- 🐛 **Interactive debugger**: Built-in stdio communication testing\n\n### ✨ Core Features\n\n| Feature | Description |\n|---------|-------------|\n| ⚡ **One-command scaffold** | `mcp-toolkit init my-server` generates a complete project in seconds |\n| 🈳 **Zero dependencies** | Core functionality relies solely on Python standard library |\n| 🔤 **Multi-language** | Supports Python, TypeScript, and JavaScript |\n| 📋 **4 Templates** | Basic / API / Data / AI covering common scenarios |\n| 🛡️ **Compliance check** | 7 automated checks ensure MCP protocol compatibility |\n| 🐛 **Built-in debugger** | Simulates MCP client communication for quick debugging |\n| 🔧 **Optional features** | Auth, logging, metrics, sandbox plugin extensions |\n| 🧪 **Test suite** | Auto-generated unit tests for code quality assurance |\n\n### 🚀 Quick Start\n\n#### Requirements\n\n- **Python** \u003e= 3.8\n- Platforms: Linux / macOS / Windows\n\n#### Installation\n\n```bash\n# Via pip\npip install mcp-toolkit-cli\n\n# Or from source\ngit clone https://github.com/gitstq/mcp-toolkit-cli.git\ncd mcp-toolkit-cli\npip install -e .\n```\n\n#### Create Your First MCP Server\n\n```bash\n# Create a basic Python MCP server\nmcp-toolkit init my-first-server --template basic --language python\n\n# Enter project directory\ncd my-first-server\n\n# Run the server\npython server.py\n```\n\n#### Validate Compliance\n\n```bash\nmcp-toolkit validate .\n# ✅ All checks passed! MCP compliant.\n```\n\n#### Debug Server\n\n```bash\nmcp-toolkit debug . --verbose\n# ✅ Server initialized successfully!\n# 🔧 Available tools (3):\n#    - hello_world: Say hello to the world\n#    - echo: Echo back the input message\n#    - calculator: Perform basic calculations\n```\n\n### 📖 Detailed Usage Guide\n\n#### Command Reference\n\n```bash\nmcp-toolkit info              # Show toolkit information\nmcp-toolkit list-templates    # List available templates\nmcp-toolkit init \u003cname\u003e       # Initialize new project\n  --template, -t    Choose template (basic/api/data/ai)\n  --language, -l    Choose language (python/typescript/javascript)\n  --features, -f    Additional features (auth/logging/metrics/sandbox)\nmcp-toolkit validate [path]   # Validate MCP compliance\nmcp-toolkit debug [path]      # Debug server\nmcp-toolkit test [path]       # Run test suite\n```\n\n#### Advanced: API Server with Auth\n\n```bash\nmcp-toolkit init my-api-server \\\n  --template api \\\n  --language python \\\n  --features auth logging\n```\n\n#### Template Overview\n\n| Template | Use Case | Built-in Tools |\n|----------|----------|----------------|\n| `basic` | General-purpose tool server | hello_world, echo, calculator |\n| `api` | External API wrapper | http_client, auth, rate_limiting |\n| `data` | Data processing pipeline | csv_parser, json_transform, validator |\n| `ai` | AI/LLM integration | prompt_template, chain_builder, model_router |\n\n### 💡 Design Philosophy \u0026 Roadmap\n\n**Tech Stack Rationale**:\n- Python chosen for its rich standard library and cross-platform compatibility\n- Zero-dependency design ensures it works out-of-the-box in any environment\n- Template engine uses pure code generation to avoid Jinja2 dependencies\n\n**Roadmap**:\n- [ ] More language templates (Go, Rust, Java)\n- [ ] MCP Inspector visual debugging integration\n- [ ] Docker packaging support\n- [ ] Remote template repository support\n- [ ] CI/CD workflow generation\n\n**Community Contributions**:\n- Submit new server templates\n- Improve multi-language documentation\n- Report MCP protocol compatibility issues\n\n### 📦 Packaging \u0026 Deployment\n\n```bash\n# Local build\npython setup.py sdist bdist_wheel\n\n# Install locally\npip install dist/mcp_toolkit_cli-1.0.0-py3-none-any.whl\n\n# Publish to PyPI (maintainers)\npython -m twine upload dist/*\n```\n\n### 🤝 Contributing\n\nPRs are welcome! Please follow these guidelines:\n\n1. **Code style**: Follow PEP 8, 4-space indentation\n2. **Commit messages**: Use Angular convention (`feat:` / `fix:` / `docs:` / `refactor:`)\n3. **Test coverage**: New features require unit tests\n4. **Documentation**: Update corresponding README language versions\n\n### 📄 License\n\nThis project is licensed under the [MIT License](LICENSE).\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**⭐ Star this repo if you find it helpful!**\n\nMade with ❤️ by [gitstq](https://github.com/gitstq)\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgitstq%2Fmcp-toolkit-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgitstq%2Fmcp-toolkit-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgitstq%2Fmcp-toolkit-cli/lists"}