MCP 服务器

CoreMCP

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.

README

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}!"