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

MIT © 2024-present [wuaikaiyuan]