Skip to content

cybertheory/mcpkit

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

26 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

MCP Kit

A lightweight UI console client for the official MCP 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.

🌐 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.

MCP Kit Screenshot

πŸš€ 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

  • Official Registry Integration: Built as a client for the official MCP Registry, ensuring all server data comes from the authoritative source
  • Registry-First Architecture: All installations use official registry metadata including npm packages, versions, and environment variables
  • Auto-Detection: Automatically finds Cursor, Windsurf, Claude Desktop, Continue, Aider, Cline, Neovim, Emacs, JetBrains IDEs and other MCP-capable agents
  • One-Click Install: Install MCP servers directly from registry with proper environment variable configuration
  • 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

  1. Start MCP Kit: Run npx @cybertheory/mcpkit or mcpkit (if installed globally)
  2. Select Agent: Choose your coding agent (Cursor, Windsurf, etc.)
  3. Browse Catalog: Explore available MCP servers
  4. Install: Click install and configure environment variables
  5. 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

🌐 Official MCP Registry Integration

MCP Kit is designed as a client for the official MCP Registry, following the specifications and standards defined by the Model Context Protocol community. This ensures:

βœ… Registry Compliance

  • Authentic Data: All server information comes directly from the official registry at registry.modelcontextprotocol.io
  • Latest Versions: Automatic updates with the most recent server versions from the registry
  • Proper Metadata: Complete package information, environment variables, and installation commands as defined by the registry
  • Verified Sources: Only officially registered and verified MCP servers are available for installation

πŸ”„ Registry Synchronization

  • Real-time Updates: Registry data is automatically updated every 30 minutes
  • Manual Refresh: Use the "Refresh Registry" button in the UI to get the latest data
  • Offline Support: Cached data ensures continued operation when the registry is unavailable
  • API Compliance: Follows the official MCP Registry API specifications for data retrieval and server management

πŸ—οΈ Architecture Benefits

  • Standards Compliance: Built according to MCP Registry specifications
  • Community Alignment: Integrates seamlessly with the broader MCP ecosystem
  • Future-Proof: Automatically adapts to registry API changes and improvements
  • Trust & Security: Users can trust that all servers come from the official, verified registry

πŸš€ Publishing

To publish a new version:

# Update version
npm version patch  # or minor, major

# Build and publish
npm run build
npm publish

🀝 Contributing

We 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.

Quick Start

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Submit a pull request

Detailed Guidelines

See our CONTRIBUTING.md for comprehensive contribution guidelines, including:

  • Development setup and project structure
  • Code style guidelines and testing requirements
  • MCP Registry integration standards
  • Review process and community guidelines

Registry Compliance

When contributing, please ensure:

  • All changes maintain compatibility with the official MCP Registry API
  • Server installations follow registry specifications
  • Error handling includes proper fallback mechanisms
  • Documentation reflects registry integration features

πŸ“„ License

MIT License - see LICENSE file for details.

πŸ†˜ Support


Made with ❀️ for the MCP community | Built for the Official MCP Registry

Releases

No releases published

Packages

No packages published