{"id":51026975,"url":"https://github.com/gitstq/mcp-server-toolkit","last_synced_at":"2026-06-21T20:02:57.115Z","repository":{"id":353008188,"uuid":"1217589613","full_name":"gitstq/mcp-server-toolkit","owner":"gitstq","description":"Production-grade MCP Server Toolkit — discover, test, deploy, and configure MCP servers with one CLI","archived":false,"fork":false,"pushed_at":"2026-04-22T03:22:56.000Z","size":89,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-22T05:25:05.646Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","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.en.md","changelog":null,"contributing":"CONTRIBUTING.md","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-04-22T03:12:42.000Z","updated_at":"2026-04-22T03:23:01.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/gitstq/mcp-server-toolkit","commit_stats":null,"previous_names":["gitstq/mcp-server-toolkit"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/gitstq/mcp-server-toolkit","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fmcp-server-toolkit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fmcp-server-toolkit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fmcp-server-toolkit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fmcp-server-toolkit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gitstq","download_url":"https://codeload.github.com/gitstq/mcp-server-toolkit/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fmcp-server-toolkit/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34623907,"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:57.002Z","updated_at":"2026-06-21T20:02:57.099Z","avatar_url":"https://github.com/gitstq.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MCP Server Toolkit\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/npm/v/mcp-server-toolkit?style=flat-square\" alt=\"npm version\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen?style=flat-square\" alt=\"Node.js\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/license-MIT-blue?style=flat-square\" alt=\"License\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/MCP-Protocol-orange?style=flat-square\" alt=\"MCP Protocol\"\u003e\n\u003c/p\u003e\n\n\u003e 🚀 One-stop MCP server discovery, testing, and deployment toolkit\n\n**MCP Server Toolkit** is a comprehensive command-line toolkit designed for AI developers working with the Model Context Protocol (MCP). It provides server discovery, schema testing, configuration generation, and deployment tools to help you easily manage the MCP ecosystem.\n\n---\n\n## ✨ Features\n\n| Feature | Description |\n|---------|-------------|\n| 🔍 **Server Discovery** | Discover MCP servers from official registry and popular sources |\n| 🧪 **Schema Testing** | Validate JSON-RPC 2.0 protocol compliance and transport health |\n| ⚙️ **Config Generator** | Generate configurations for Claude, OpenAI, and custom MCP clients |\n| 🚀 **One-Click Deploy** | Deploy to local, Docker, Vercel, or Fly.io platforms |\n| 📦 **Project Init** | Bootstrap new MCP server projects from templates |\n| 🗂️ **Server Registry** | Built-in registry of 18+ official and popular MCP servers |\n\n---\n\n## 📦 Quick Start\n\n### Global Installation\n\n```bash\nnpm install -g mcp-server-toolkit\n```\n\n### Run Without Installation\n\n```bash\nnpx mcp-toolkit discover\n```\n\n### Verify Installation\n\n```bash\nmcp-toolkit --version\n# Output: 1.0.0\n```\n\n---\n\n## 🚀 Usage Guide\n\n### 1. Discover MCP Servers\n\n```bash\n# Discover all available servers\nmcp-toolkit discover\n\n# View official servers only\nmcp-toolkit discover --source official\n\n# Search by keyword\nmcp-toolkit discover --keyword database\n\n# Save results to file\nmcp-toolkit discover --output servers.json\n```\n\n### 2. View Server Details\n\n```bash\n# List all known servers\nmcp-toolkit list\n\n# View specific server details\nmcp-toolkit info mcp/github\n```\n\n### 3. Test Servers\n\n```bash\n# Test server schema compliance\nmcp-toolkit test mcp/github\n\n# Custom timeout\nmcp-toolkit test mcp/github --timeout 5000\n\n# Verbose output mode\nmcp-toolkit test mcp/github --verbose\n```\n\n### 4. Generate Client Configurations\n\n```bash\n# Generate Claude Desktop config\nmcp-toolkit config mcp/filesystem --client claude -o claude_desktop_config.json\n\n# Generate OpenAI config\nmcp-toolkit config mcp/github --client openai -o openai_config.json\n\n# Generate generic MCP client config\nmcp-toolkit config mcp/github --client anything -o mcp_config.json\n```\n\n### 5. Initialize New Projects\n\n```bash\n# Create project with minimal template\nmcp-toolkit init my-server --template minimal\n\n# Use full template\nmcp-toolkit init my-server --template full\n```\n\n### 6. Deploy Servers\n\n```bash\n# Docker deployment\nmcp-toolkit deploy ./my-server --platform docker\n\n# Vercel deployment\nmcp-toolkit deploy ./my-server --platform vercel\n\n# Fly.io deployment\nmcp-toolkit deploy ./my-server --platform flyio\n```\n\n---\n\n## 🌐 Supported Sources\n\n| Source | Description | Server Count |\n|--------|-------------|--------------|\n| `official` | MCP Official Servers (Anthropic) | 10 |\n| `popular` | Popular third-party integrations | 8 |\n| `all` | All sources combined | 18 |\n\n---\n\n## 🗂️ Server Registry\n\n### Official Servers\n\n| ID | Name | Category | Description |\n|----|------|----------|-------------|\n| `mcp/filesystem` | Filesystem | Utility | File system operations |\n| `mcp/github` | GitHub | Integration | GitHub API integration |\n| `mcp/brave-search` | Brave Search | Search | Brave search engine |\n| `mcp/sentry` | Sentry | Monitoring | Error monitoring |\n| `mcp/slack` | Slack | Communication | Slack messaging |\n| `mcp/sqlite` | SQLite | Database | SQLite database |\n| `mcp/postgres` | PostgreSQL | Database | PostgreSQL database |\n| `mcp/aws-kb-retrieval` | AWS KB | AI | AWS knowledge base retrieval |\n| `mcp/google-maps` | Google Maps | Utility | Map services |\n| `mcp/everart` | Everart | AI | AI image generation |\n\n### Popular Third-Party\n\n| ID | Provider | Category | Description |\n|----|----------|----------|-------------|\n| `anthropic/claude-code` | Anthropic | AI | Claude Code |\n| `alibaba/dashscope` | Alibaba | AI | Tongyi Qianwen |\n| `baidu/qianfan` | Baidu | AI | Wenxin Yiyan |\n| `tencent/cloud` | Tencent | AI | Tencent Cloud AI |\n| `notion/notion-api` | Notion | Productivity | Notion API |\n| `linear/linear-api` | Linear | Productivity | Linear project management |\n| `stripe/stripe-api` | Stripe | Commerce | Payment processing |\n| `datadog/datadog-api` | Datadog | Monitoring | Application monitoring |\n\n---\n\n## 💡 Design Philosophy\n\n### Why Create This Tool?\n\nMCP (Model Context Protocol) is an open protocol launched by Anthropic to standardize how AI assistants connect to external data and tools. As the MCP ecosystem rapidly evolves, developers face several challenges:\n\n1. **Discovery Difficulty** - MCP servers are scattered across different repositories and documentation\n2. **Complex Testing** - Manual verification of each server's protocol compliance is required\n3. **Tedious Configuration** - Different clients require different configuration formats\n4. **Fragmented Deployment** - Lack of unified deployment workflows\n\n**MCP Server Toolkit** was created to solve these problems, providing a one-stop solution from discovery to deployment.\n\n### Architecture\n\n```\nmcp-server-toolkit/\n├── bin/cli.js              # CLI entry point\n├── src/\n│   ├── commands/           # Command implementations\n│   │   ├── discover.js     # Discovery command\n│   │   ├── test.js         # Test command\n│   │   ├── config.js       # Config command\n│   │   ├── deploy.js       # Deploy command\n│   │   ├── list.js         # List command\n│   │   ├── info.js         # Info command\n│   │   └── init.js         # Init command\n│   └── lib/\n│       ├── sources/        # Server registry\n│       ├── test/           # Testing framework\n│       ├── config/         # Config generation\n│       └── deploy/         # Deployment tools\n├── tests/                  # Test suites\n└── configs/                # Config templates\n```\n\n### Technology Stack\n\n- **Node.js 18+** - Native ES Modules support\n- **Commander.js** - Mature and stable CLI framework\n- **Chalk** - Terminal color output\n- **Ora** - Elegant loading animations\n- **Inquirer** - Interactive command line\n- **Jest** - Comprehensive test coverage\n\n---\n\n## 🤝 Contributing\n\nWe welcome all forms of contributions!\n\n### Submitting Issues\n\n- Use a clear title to describe the problem\n- Provide reproduction steps and environment information\n- Attach error logs if applicable\n\n### Submitting Pull Requests\n\n1. Fork this repository\n2. Create a feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Create a Pull Request\n\n### Development Environment\n\n```bash\n# Clone the repository\ngit clone https://github.com/gitstq/mcp-server-toolkit.git\ncd mcp-server-toolkit\n\n# Install dependencies\nnpm install\n\n# Run tests\nnpm test\n\n# Run locally\nnpm start\n\n# Link for local development\nnpm link\n```\n\n### Code Standards\n\n- Use ESLint for code linting\n- Use Prettier for code formatting\n- Maintain test coverage \u003e 90%\n\n---\n\n## 📄 License\n\nThis project is open-sourced under the [MIT License](LICENSE).\n\n```\nMIT License\n\nCopyright (c) 2026 gitstq\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n```\n\n---\n\n## 🔗 Related Projects\n\n- [mcp-flow](https://github.com/gitstq/mcp-flow) - MCP flow orchestration engine\n- [agent-adapter](https://github.com/gitstq/agent-adapter) - Universal Agent adapter layer\n- [awesome-ai-agent-skills](https://github.com/gitstq/awesome-ai-agent-skills) - AI Agent skills collection\n\n---\n\n\u003cp align=\"center\"\u003e\n  Made with ❤️ by \u003ca href=\"https://github.com/gitstq\"\u003egitstq\u003c/a\u003e\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgitstq%2Fmcp-server-toolkit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgitstq%2Fmcp-server-toolkit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgitstq%2Fmcp-server-toolkit/lists"}