@cybertheory/mcpkit

MCP Kit

A lightweight UI console to detect MCP-capable agents and install 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.

🚀 Quick Start

Option 1: NPX (Recommended - No Installation)

npx @cybertheory/mcpkit

📰 News Ticker (Free & Ready!)

The news ticker displays real tech headlines automatically - no setup required!

Features:

• ✅ Completely Free - No API key needed
• ✅ Real Tech News - Live headlines from major sources
• ✅ Auto-Updates - Refreshes every 5 minutes
• ✅ Smart Filtering - Only shows relevant tech content

News Coverage Includes:

• AI & Machine Learning (Claude, OpenAI, Anthropic, MCP)
• Programming Languages & Frameworks (JavaScript, Python, React, Node.js, etc.)
• Major Tech Companies (Google, Apple, Microsoft, Amazon, Meta, Tesla, SpaceX)
• Software Development & DevOps
• Cloud Computing & Cybersecurity
• Blockchain & Cryptocurrency
• Tech Startups & Innovation
• Tech Conferences & Events

The ticker uses a free news proxy service and works out of the box! No installation required! Runs immediately and caches for faster subsequent runs.

Option 2: Global Installation

npm install -g @cybertheory/mcpkit
mcpkit

Option 3: Local Installation

npm install @cybertheory/mcpkit
npx @cybertheory/mcpkit

✨ Features

• Auto-Detection: Automatically finds Cursor, Windsurf, Claude Desktop, Continue, Aider, Cline, Neovim, Emacs, JetBrains IDEs and other MCP-capable agents
• Official Registry Integration: Direct integration with the official MCP registry (registry.modelcontextprotocol.io) for authentic server data
• One-Click Install: Install MCP servers directly from registry with proper environment variable configuration
• Registry-First: All installations use official registry metadata including npm packages, versions, and environment variables
• OAuth Support: Handle authentication flows for services like GitHub
• Offline Fallback: Works even when registry is unavailable using cached data
• Cross-Platform: Windows, macOS, and Linux support

🎯 Supported Agents

Code Editors

• Cursor - AI-powered code editor
• Windsurf - AI coding assistant by Codeium
• Continue - Open-source AI coding assistant
• Cline - AI-powered coding assistant for VS Code
• VS Code - Visual Studio Code with MCP extensions
• Neovim - Modern Vim with MCP support
• Emacs - Extensible text editor with MCP integration
• JetBrains IDEs - IntelliJ IDEA, PyCharm, WebStorm with MCP

AI Assistants

• Claude Desktop - Anthropic's Claude AI assistant
• ChatGPT - OpenAI's ChatGPT with MCP integration
• Perplexity AI - AI-powered search and research assistant

Terminal Tools

• Aider - AI pair programming in your terminal

Productivity & Communication

• Notion AI - AI-powered workspace and productivity tool
• Obsidian - Knowledge management with AI plugins
• Slack - Team communication with AI integrations
• Discord - Community platform with bot integrations
• Zapier - Automation platform connecting apps and services

Custom Agents

• Custom Agents - Add your own MCP-compatible tools

📦 Installation Methods

NPX (No Installation Required)

# Latest version
npx @cybertheory/mcpkit

# Specific version
npx @cybertheory/mcpkit@1.2.3

# Force update
npx @cybertheory/mcpkit@latest --force

Pros:

• ✅ No installation required
• ✅ Always latest version
• ✅ No system pollution
• ✅ Easy to try
• ✅ Works offline after first run

Cons:

• ❌ Requires Node.js
• ❌ Slower first run (downloads package)

Global Installation

npm install -g @cybertheory/mcpkit
# or
yarn global add @cybertheory/mcpkit

Pros:

• ✅ Fast startup
• ✅ Works offline
• ✅ Version control
• ✅ Available as mcp-kit command

Cons:

• ❌ Requires Node.js
• ❌ Manual updates needed

Local Installation

npm install @cybertheory/mcpkit
npx @cybertheory/mcpkit

Pros:

• ✅ Project-specific installation
• ✅ Version pinning
• ✅ Works offline

Cons:

• ❌ Requires Node.js
• ❌ Must run from project directory

🛠️ Development

Prerequisites

• Node.js 16+
• npm or yarn

Setup

git clone https://github.com/cybertheory/mcpkit.git
cd mcpkit
npm install
npm run dev

Building

# Build web assets
npm run build

# Publish to npm
npm publish

📋 Usage

• Start MCP Kit: Run npx @cybertheory/mcpkit or mcpkit (if installed globally)
• Select Agent: Choose your coding agent (Cursor, Windsurf, etc.)
• Browse Catalog: Explore available MCP servers
• Install: Click install and configure environment variables
• Use: Restart your agent to use the new MCP servers

🔧 Configuration

MCP Kit automatically detects agent configurations, but you can manually specify paths if needed:

Code Editors

• Cursor: ~/.cursor/mcp.json
• Windsurf: ~/.windsurf/mcp.json
• Continue: ~/.continue/config.json
• Cline: ~/.cline/config.json (VS Code extension with MCP support)
• Neovim: ~/.neovim/mcp.json
• Emacs: ~/.emacs/mcp.json
• JetBrains: ~/.jetbrains/mcp.json

AI Assistants

• Claude Desktop: ~/.claude/mcp.json
• ChatGPT: Custom configuration file
• Perplexity AI: Custom configuration file

Terminal Tools

• Aider: ~/.aiderrc or ~/.aider/config.json

Custom Agents

• Custom: Specify any JSON configuration file

🌐 Registry

MCP Kit uses the official MCP registry (registry.modelcontextprotocol.io) as the primary source for all server data. This ensures:

• ✅ Authentic Data: All server information comes directly from the official registry
• ✅ Latest Versions: Automatic updates with the most recent server versions
• ✅ Proper Metadata: Complete package information, environment variables, and installation commands
• ✅ Verified Sources: Only officially registered and verified MCP servers

The registry is automatically updated every 30 minutes, and you can manually refresh using the "Refresh Registry" button in the UI. If the official registry is unavailable, MCP Kit falls back to cached data to ensure continued operation.

🚀 Publishing

To publish a new version:

# Update version
npm version patch  # or minor, major

# Build and publish
npm run build
npm publish

🤝 Contributing

• Fork the repository
• Create a feature branch
• Make your changes
• Submit a pull request

📄 License

MIT License - see LICENSE file for details.

🆘 Support

• Issues: GitHub Issues
• Discussions: GitHub Discussions
• Documentation: Wiki

Made with ❤️ for the MCP community