{"id":31328048,"url":"https://github.com/cybertheory/mcpkit","last_synced_at":"2026-01-20T16:54:43.941Z","repository":{"id":314983657,"uuid":"1057150527","full_name":"cybertheory/mcpkit","owner":"cybertheory","description":"Easy to use MCP UI","archived":false,"fork":false,"pushed_at":"2025-09-16T02:56:13.000Z","size":502,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-16T03:28:20.889Z","etag":null,"topics":["agents","claude","cursor","dashboard","mcp","mcp-client","mcp-database","mcp-directory","mcp-server","mcp-ui","windsurf"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cybertheory.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2025-09-15T10:43:44.000Z","updated_at":"2025-09-16T02:56:16.000Z","dependencies_parsed_at":"2025-09-16T03:28:23.208Z","dependency_job_id":"dd7f4798-0ede-41ff-9f9b-24e9905e0640","html_url":"https://github.com/cybertheory/mcpkit","commit_stats":null,"previous_names":["cybertheory/mcpkit"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/cybertheory/mcpkit","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cybertheory%2Fmcpkit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cybertheory%2Fmcpkit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cybertheory%2Fmcpkit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cybertheory%2Fmcpkit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cybertheory","download_url":"https://codeload.github.com/cybertheory/mcpkit/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cybertheory%2Fmcpkit/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":276138323,"owners_count":25591870,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-20T02:00:10.207Z","response_time":63,"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":["agents","claude","cursor","dashboard","mcp","mcp-client","mcp-database","mcp-directory","mcp-server","mcp-ui","windsurf"],"created_at":"2025-09-25T23:45:40.226Z","updated_at":"2025-09-25T23:45:40.857Z","avatar_url":"https://github.com/cybertheory.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MCP Kit\n\nA lightweight UI console client for the [official MCP Registry](https://github.com/modelcontextprotocol/registry) that detects MCP-capable agents and installs MCP servers. Easily manage Model Context Protocol integrations for Cursor, Windsurf, Claude Desktop, Continue, Aider, Cline, Neovim, Emacs, JetBrains IDEs and other MCP-capable assistants.\n\n\u003e **🌐 Official Registry Client**: MCP Kit is built as a client for the official MCP Registry, following the specifications and standards defined by the Model Context Protocol community. All server data comes directly from [registry.modelcontextprotocol.io](https://registry.modelcontextprotocol.io).\n\n![MCP Kit Screenshot](assets/image.png)\n\n## 🚀 Quick Start\n\n### Option 1: NPX (Recommended - No Installation)\n```bash\nnpx @cybertheory/mcpkit\n```\n\n### 📰 News Ticker (Free \u0026 Ready!)\n\nThe news ticker displays real tech headlines automatically - **no setup required!**\n\n**Features:**\n- ✅ **Completely Free** - No API key needed\n- ✅ **Real Tech News** - Live headlines from major sources\n- ✅ **Auto-Updates** - Refreshes every 5 minutes\n- ✅ **Smart Filtering** - Only shows relevant tech content\n\n**News Coverage Includes:**\n- AI \u0026 Machine Learning (Claude, OpenAI, Anthropic, MCP)\n- Programming Languages \u0026 Frameworks (JavaScript, Python, React, Node.js, etc.)\n- Major Tech Companies (Google, Apple, Microsoft, Amazon, Meta, Tesla, SpaceX)\n- Software Development \u0026 DevOps\n- Cloud Computing \u0026 Cybersecurity\n- Blockchain \u0026 Cryptocurrency\n- Tech Startups \u0026 Innovation\n- Tech Conferences \u0026 Events\n\nThe ticker uses a free news proxy service and works out of the box!\nNo installation required! Runs immediately and caches for faster subsequent runs.\n\n### Option 2: Global Installation\n```bash\nnpm install -g @cybertheory/mcpkit\nmcpkit\n```\n\n### Option 3: Local Installation\n```bash\nnpm install @cybertheory/mcpkit\nnpx @cybertheory/mcpkit\n```\n\n## ✨ Features\n\n- **Official Registry Integration**: Built as a client for the [official MCP Registry](https://github.com/modelcontextprotocol/registry), ensuring all server data comes from the authoritative source\n- **Registry-First Architecture**: All installations use official registry metadata including npm packages, versions, and environment variables\n- **Auto-Detection**: Automatically finds Cursor, Windsurf, Claude Desktop, Continue, Aider, Cline, Neovim, Emacs, JetBrains IDEs and other MCP-capable agents\n- **One-Click Install**: Install MCP servers directly from registry with proper environment variable configuration\n- **OAuth Support**: Handle authentication flows for services like GitHub\n- **Offline Fallback**: Works even when registry is unavailable using cached data\n- **Cross-Platform**: Windows, macOS, and Linux support\n\n## 🎯 Supported Agents\n\n### Code Editors\n- **Cursor** - AI-powered code editor\n- **Windsurf** - AI coding assistant by Codeium\n- **Continue** - Open-source AI coding assistant\n- **Cline** - AI-powered coding assistant for VS Code\n- **VS Code** - Visual Studio Code with MCP extensions\n- **Neovim** - Modern Vim with MCP support\n- **Emacs** - Extensible text editor with MCP integration\n- **JetBrains IDEs** - IntelliJ IDEA, PyCharm, WebStorm with MCP\n\n### AI Assistants\n- **Claude Desktop** - Anthropic's Claude AI assistant\n- **ChatGPT** - OpenAI's ChatGPT with MCP integration\n- **Perplexity AI** - AI-powered search and research assistant\n\n### Terminal Tools\n- **Aider** - AI pair programming in your terminal\n\n### Productivity \u0026 Communication\n- **Notion AI** - AI-powered workspace and productivity tool\n- **Obsidian** - Knowledge management with AI plugins\n- **Slack** - Team communication with AI integrations\n- **Discord** - Community platform with bot integrations\n- **Zapier** - Automation platform connecting apps and services\n\n### Custom Agents\n- **Custom Agents** - Add your own MCP-compatible tools\n\n## 📦 Installation Methods\n\n### NPX (No Installation Required)\n```bash\n# Latest version\nnpx @cybertheory/mcpkit\n\n# Specific version\nnpx @cybertheory/mcpkit@1.2.3\n\n# Force update\nnpx @cybertheory/mcpkit@latest --force\n```\n\n**Pros:**\n- ✅ No installation required\n- ✅ Always latest version\n- ✅ No system pollution\n- ✅ Easy to try\n- ✅ Works offline after first run\n\n**Cons:**\n- ❌ Requires Node.js\n- ❌ Slower first run (downloads package)\n\n### Global Installation\n```bash\nnpm install -g @cybertheory/mcpkit\n# or\nyarn global add @cybertheory/mcpkit\n```\n\n**Pros:**\n- ✅ Fast startup\n- ✅ Works offline\n- ✅ Version control\n- ✅ Available as `mcp-kit` command\n\n**Cons:**\n- ❌ Requires Node.js\n- ❌ Manual updates needed\n\n### Local Installation\n```bash\nnpm install @cybertheory/mcpkit\nnpx @cybertheory/mcpkit\n```\n\n**Pros:**\n- ✅ Project-specific installation\n- ✅ Version pinning\n- ✅ Works offline\n\n**Cons:**\n- ❌ Requires Node.js\n- ❌ Must run from project directory\n\n## 🛠️ Development\n\n### Prerequisites\n- Node.js 16+\n- npm or yarn\n\n### Setup\n```bash\ngit clone https://github.com/cybertheory/mcpkit.git\ncd mcpkit\nnpm install\nnpm run dev\n```\n\n### Building\n```bash\n# Build web assets\nnpm run build\n\n# Publish to npm\nnpm publish\n```\n\n## 📋 Usage\n\n1. **Start MCP Kit**: Run `npx @cybertheory/mcpkit` or `mcpkit` (if installed globally)\n2. **Select Agent**: Choose your coding agent (Cursor, Windsurf, etc.)\n3. **Browse Catalog**: Explore available MCP servers\n4. **Install**: Click install and configure environment variables\n5. **Use**: Restart your agent to use the new MCP servers\n\n## 🔧 Configuration\n\nMCP Kit automatically detects agent configurations, but you can manually specify paths if needed:\n\n### Code Editors\n- **Cursor**: `~/.cursor/mcp.json`\n- **Windsurf**: `~/.windsurf/mcp.json`\n- **Continue**: `~/.continue/config.json`\n- **Cline**: `~/.cline/config.json` (VS Code extension with MCP support)\n- **Neovim**: `~/.neovim/mcp.json`\n- **Emacs**: `~/.emacs/mcp.json`\n- **JetBrains**: `~/.jetbrains/mcp.json`\n\n### AI Assistants\n- **Claude Desktop**: `~/.claude/mcp.json`\n- **ChatGPT**: Custom configuration file\n- **Perplexity AI**: Custom configuration file\n\n### Terminal Tools\n- **Aider**: `~/.aiderrc` or `~/.aider/config.json`\n\n### Custom Agents\n- **Custom**: Specify any JSON configuration file\n\n## 🌐 Official MCP Registry Integration\n\nMCP Kit is designed as a client for the [official MCP Registry](https://github.com/modelcontextprotocol/registry), following the specifications and standards defined by the Model Context Protocol community. This ensures:\n\n### ✅ Registry Compliance\n- **Authentic Data**: All server information comes directly from the official registry at [registry.modelcontextprotocol.io](https://registry.modelcontextprotocol.io)\n- **Latest Versions**: Automatic updates with the most recent server versions from the registry\n- **Proper Metadata**: Complete package information, environment variables, and installation commands as defined by the registry\n- **Verified Sources**: Only officially registered and verified MCP servers are available for installation\n\n### 🔄 Registry Synchronization\n- **Real-time Updates**: Registry data is automatically updated every 30 minutes\n- **Manual Refresh**: Use the \"Refresh Registry\" button in the UI to get the latest data\n- **Offline Support**: Cached data ensures continued operation when the registry is unavailable\n- **API Compliance**: Follows the official MCP Registry API specifications for data retrieval and server management\n\n### 🏗️ Architecture Benefits\n- **Standards Compliance**: Built according to MCP Registry specifications\n- **Community Alignment**: Integrates seamlessly with the broader MCP ecosystem\n- **Future-Proof**: Automatically adapts to registry API changes and improvements\n- **Trust \u0026 Security**: Users can trust that all servers come from the official, verified registry\n\n## 🚀 Publishing\n\nTo publish a new version:\n\n```bash\n# Update version\nnpm version patch  # or minor, major\n\n# Build and publish\nnpm run build\nnpm publish\n```\n\n## 🤝 Contributing\n\nWe welcome contributions to MCP Kit! As a client for the official MCP Registry, we follow the specifications and standards defined by the Model Context Protocol community.\n\n### Quick Start\n1. Fork the repository\n2. Create a feature branch\n3. Make your changes\n4. Submit a pull request\n\n### Detailed Guidelines\nSee our [CONTRIBUTING.md](CONTRIBUTING.md) for comprehensive contribution guidelines, including:\n- Development setup and project structure\n- Code style guidelines and testing requirements\n- MCP Registry integration standards\n- Review process and community guidelines\n\n### Registry Compliance\nWhen contributing, please ensure:\n- All changes maintain compatibility with the official MCP Registry API\n- Server installations follow registry specifications\n- Error handling includes proper fallback mechanisms\n- Documentation reflects registry integration features\n\n## 📄 License\n\nMIT License - see [LICENSE](LICENSE) file for details.\n\n## 🆘 Support\n\n- **Issues**: [GitHub Issues](https://github.com/cybertheory/mcpkit/issues)\n- **Discussions**: [GitHub Discussions](https://github.com/cybertheory/mcpkit/discussions)\n- **Documentation**: [Wiki](https://github.com/cybertheory/mcpkit/wiki)\n\n---\n\n**Made with ❤️ for the MCP community** | **Built for the [Official MCP Registry](https://github.com/modelcontextprotocol/registry)**","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcybertheory%2Fmcpkit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcybertheory%2Fmcpkit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcybertheory%2Fmcpkit/lists"}