CoreMCP

CoreMCP · Central Hub for Model Context Protocols

🧠 Build, manage, and call your local AI tools — with one unified MCP gateway, one protocol to connect them all.

✨ What is CoreMCP?

CoreMCP is a lightweight, modular orchestration hub for running and managing all your local MCP tools (Model Context Protocols) in a unified way — across your IDEs, terminal, and custom AI assistants.

It connects your Python-based AI tools, UI interfaces, and editor plugins into a consistent, extensible, and elegant local system.

🔧 Key Features

🧩 MCP Gateway – Single entry point for all local tools, built with FastAPI + WebSocket.
🖥️ Unified UI Server – Dynamic web-based UI (React/Tauri) for cross-tool interactions.
⚙️ Plugin SDKs – Call MCP tools from Cursor, VS Code, PyCharm, CLI, or your own agent.
🔁 Session Management – Persistent workflows with full context lifecycle.
🛠️ Dynamic Tool Registration – Add new MCP modules via simple decorators.
🔒 Local-first & Secure – Runs fully offline with token-auth and IPC/WebSocket options.

🚀 Quick Start

1. Clone the repo

git clone https://github.com/your-org/coremcp.git
cd coremcp

2. Install and run Gateway

cd mcp_gateway
pip install -r requirements.txt
python main.py

3. Run UI service (Tauri or Web)

cd mcp_ui
npm install
npm run dev

4. Call a tool from CLI

python examples/call_tool.py \
  --tool collect_feedback \
  --input "{'summary': 'Here is the AI task result'}"

Or from the VS Code plugin (coming soon).

📦 Supported MCP Tools

Tool	Description	UI Required
`mcp-feedback-collector`	Collects human feedback for AI outputs	✅
`mcp-summarizer`	Summarizes text using local LLM APIs	❌
`mcp-context-cache`	Stores/retrieves working memory	❌
(Add your own!)	Just decorate with `@mcp.tool()`	Depends

🧠 How It Works

+------------+        +------------------+        +------------------+
|  IDE/CLI   |  ==>   |   CoreMCP Hub    |  ==>   |   MCP Tool (Py)  |
| Plugin/SDK |        |  - Tool Router   |        | - Collect/Reply  |
+------------+        |  - Session Mgmt  |        +------------------+
                           |
                           v
                     +--------------+
                     |   UI Server  |
                     | (Tauri/Web)  |
                     +--------------+

🛠️ Build Your Own MCP Tool

# mcp_tools/mcp_hello/tool.py

from coremcp import mcp

@mcp.tool(name="hello", ui="SimpleInput")
def hello_tool(input: dict):
    name = input.get("name", "World")
    return f"Hello, {name}!"

Add to your mcp_tools folder and it will be auto-registered!

🔐 Local-First Security

✅ Runs on localhost only (default)
🔑 Token-based authorization
🔁 Supports IPC or WebSocket routing
🧪 Safe tool sandboxing coming soon

📚 Docs & Community

📖 Getting Started Guide
📦 Tool Plugin System
💬 Join the Discord (planned)
🧪 Coming soon: marketplace, remote agent support, CLI generator...

🧱 Tech Stack

🐍 Python 3.11, FastAPI, WebSocket
🌐 React + Vite + Tailwind (UI)
🧳 Tauri (native desktop build)
⚡ JSON Schema + Dynamic UI render
🔗 Local plugin SDKs: TS / Python

📜 License

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

A lightweight orchestration hub for managing local Model Context Protocol (MCP) tools in a unified way, allowing users to build, manage, and call their AI tools from IDEs, terminal, and custom assistants.

Related MCP Servers

OpenAI MCP Server
arthurcolle
-
security
F
license
-
quality
A Model Context Protocol server implementation that enables connection between OpenAI APIs and MCP clients for coding assistance with features like CLI interaction, web API integration, and tool-based architecture.
Last updated -
28
Python
Agent Construct
batteryshark
-
security
A
license
-
quality
An MCP server implementation that standardizes how AI applications access tools and context, providing a central hub that manages tool discovery, execution, and context management with a simplified configuration system.
Last updated -
9
Python
MIT License
MemoDB MCP Server
wuyunmei
-
security
F
license
-
quality
Manages AI conversation context and personal knowledge bases through the Model Context Protocol (MCP), providing tools for user data, conversation content, and knowledge management.
Last updated -
1
TypeScript
MCP Starter
instructa
A
security
A
license
A
quality
A foundation for building custom local Model Context Protocol (MCP) servers that provide tools accessible to AI assistants like Cursor or Claude Desktop.
Last updated -
1
9
TypeScript
MIT License

View all related MCP servers