代理管理工具

MCP Proxy Manager是一个轻量级代理服务器,用于在MCP客户端和MCP服务器之间进行中介,提供实时工具定义修改和调试功能。

  • by Kimsunmin
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 Kimsunmin/mcp-proxy-manager

使用说明

# MCP代理管理器

用于Model Context Protocol(MCP)的轻量级代理服务器。

它位于MCP客户端(Claude Desktop、Cursor等)和实际MCP服务器之间。通过仪表板实时查看工具定义。 **立即修改说明(提示)**可以。无需重新启动后端或修改代码。

对于工具提示工程或LLM交互调试非常有用。

开始(Quick Start)

  1. 运行原始MCP服务器 (例如,8080端口)。

  2. 代理运行:

    # 기본값: http://localhost:8080/sse 로 연결
    npm run dev
    
    # 다른 URL 지정 시
    ORIGINAL_MCP_URL=http://localhost:9000/sse npm run dev
    
  3. 连接仪表板: http://localhost:3000/dashboard 请转到。可以看到服务器上的工具列表,您可以在此处修改说明。

  4. 客户端连接: 在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