@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, and other AI coding assistants.

🚀 Quick Start

Option 1: NPX (Recommended - No Installation)

npx @cybertheory/mcpkit

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, and other MCP-capable agents
• Live Registry: Always up-to-date MCP server catalog from GitHub
• One-Click Install: Install MCP servers with environment variable configuration
• OAuth Support: Handle authentication flows for services like GitHub
• Offline Fallback: Works even when GitHub is unavailable
• Cross-Platform: Windows, macOS, and Linux support

🎯 Supported Agents

• Cursor - AI-powered code editor
• Windsurf - AI coding assistant
• 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:

• Cursor: ~/.cursor/mcp.json
• Windsurf: ~/.windsurf/mcp.json
• Custom: Specify any JSON configuration file

🌐 Registry

The MCP registry is automatically updated from GitHub every 30 minutes. You can manually refresh using the "Refresh Registry" button in the UI.

🚀 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