MCP代理管理器
用于Model Context Protocol(MCP)的轻量级代理服务器。
它位于MCP客户端(Claude Desktop、Cursor等)和实际MCP服务器之间。通过仪表板实时查看工具定义。 立即修改说明(提示)可以。无需重新启动后端或修改代码。
对于工具提示工程或LLM交互调试非常有用。
开始(Quick Start)
- 运行原始MCP服务器 (例如,8080端口)。
- 代理运行:
# 기본값: http://localhost:8080/sse 로 연결
npm run dev
# 다른 URL 지정 시
ORIGINAL_MCP_URL=http://localhost:9000/sse npm run dev- 连接仪表板:
http://localhost:3000/dashboard 请转到。可以看到服务器上的工具列表,您可以在此处修改说明。
- 客户端连接:
在MCP客户端(Claude/Cursor)设置中,输入代理地址而不是原始服务器:
http://localhost:3000/api/mcp/v1/sse
工作原理
sequenceDiagram
participant Client as MCP Client
participant Proxy as MCP Proxy Manager
participant Server as Original MCP Server
Note over Proxy: 1. SSE 스트림 가로채기
Client->>Proxy: 연결 요청
Proxy->>Server: 원본 서버 연결
Server-->>Proxy: 툴 목록 전송 (tools/list)
Proxy-->>Proxy: 저장된 프롬프트(설명) 덮어쓰기
Proxy-->>Client: 수정된 툴 목록 전달
Note over Proxy: 2. 툴 실행 중계
Client->>Proxy: 툴 실행 요청 (POST)
Proxy->>Server: 요청 전달
Server-->>Proxy: 실행 결과 반환
Proxy-->>Client: 결과 전달- 发现(Discovery):横切SSE流。服务器
tools/list发送结果时,将注入仪表板上保存的修改(override)并将其传递给客户端。 - 执行(Execution):自动重写端点地址。客户端运行工具时,请求将通过代理透明地发送到源服务器。
技术堆栈
- Next.js 15(应用路由器)
- Tailwind CSS
- 模型上下文协议SDK
