返回市场
开放MCP客户端

开放MCP客户端

作者:LSTM-Kirigaya651 星标更新:2025-11-08

项目介绍

<div align="center"> <img src="./icons/openmcp.png" height="200px"/> <h3>OpenMCP:MCP开发所需的一切</h3>

English | 中文

<a href="https://openmcp.kirigaya.cn" target="_blank" style="display: inline-block; padding: 8px 16px; background-color: rgb(84, 176, 84); color: white; border-radius: .5em; text-decoration: none;">🫱 官方文档</a>

<a href="https://qm.qq.com/cgi-bin/qm/qr?k=C6ZUTZvfqWoI12lWe7L93cWa1hUsuVT0&jump_from=webapi&authKey=McW6B1ogTPjPDrCyGttS890tMZGQ1KB3QLuG4aqVNRaYp4vlTSgf2c6dMcNjMuBD" target="_blank" style="display: inline-block; padding: 8px 16px; background-color: #CB81DA; color: white; border-radius: .5em; text-decoration: none;">OpenMCP QQ群</a>

<a href="https://discord.gg/SKTZRf6NzU" target="_blank" style="display: inline-block; padding: 8px 16px; background-color: rgb(84, 176, 84); color: white; border-radius: .5em; text-decoration: none;">OpenMCP Discord频道</a>

</div>

OpenMCP

一个集成了vscode/trae/cursor插件的MCP服务器调试工具。

IMAGE ALT TEXT HERE

👆 全视频

openmcp-client

集成检查器+MCP客户端基本功能,结合开发和测试于一体。

使用各种工具测试mcp工具、提示和资源。

测试过的工具可以放置在“交互测试”模块中进行大规模模型交互测试。

完整的项目级管理面板,便于在项目和全局级别上管理MCP项目。

支持多种大型模型

支持XML模式和自定义选项以供您选择工具。

openmcp-sdk

openmcp-client中测试并验证一切后,您可以使用openmcp-sdk快速轻松地部署您的mcp作为代理应用:

npm install openmcp-sdk

然后只需几行代码即可部署您的代理

import { OmAgent } from 'openmcp-sdk/service/sdk';

// 创建代理
const agent = new OmAgent();
    
// 加载配置,这些配置可以在使用openmcp客户端调试后自动生成
agent.loadMcpConfig('./mcpconfig.json');

// 读取调试过的提示
const prompt = await agent.getPrompt('hacknews', { topn: '5' });    

// 执行任务
const res = await agent.ainvoke({ messages: prompt });

console.log('⚙️ 代理响应', res);

输出

[2025/6/20 20:47:31] 🚀 [crawl4ai-mcp] 1.9.1 已连接
[2025/6/20 20:47:35] 🤖 代理希望使用这些工具获取get_web_markdown
[2025/6/20 20:47:35] 🔧 使用工具get_web_markdown
[2025/6/20 20:47:39] ✓ 使用工具成功
[2025/6/20 20:47:46] 🤖 代理希望使用这些工具get_web_markdown, get_web_markdown, get_web_markdown
[2025/6/20 20:47:46] 🔧 使用工具get_web_markdown
[2025/6/20 20:47:48] ✓ 使用工具成功
[2025/6/20 20:47:48] 🔧 使用工具get_web_markdown
[2025/6/20 20:47:54] ✓ 使用工具成功
[2025/6/20 20:47:54] 🔧 使用工具get_web_markdown
[2025/6/20 20:47:57] ✓ 使用工具成功

⚙️ 代理响应
⌨️ 今日科技文章汇总

📌 如何检测或观察通过的引力波?
概述:本文探讨了引力波的物理学,解释了它们对时空的影响以及人类如何感知或观察这种宇宙现象。
作者:ynoxinul
发布:2小时前
链接:https://physics.stackexchange.com/questions/338912/how-would-a-passing-gravitational-wave-look-or-feel

📌 学习Makefile教程
概述:一份全面的Makefile教程,适用于初学者和高级用户,涵盖基础语法、变量、自动规则和高级特性,帮助开发者高效管理项目构建。
作者:dsego
发布:4小时前
链接:https://makefiletutorial.com/

📌 Hurl:运行和平测试HTTP请求的纯文本
概述:Hurl是一款命令行工具,允许以纯文本格式定义和执行HTTP请求,非常适合数据抓取和HTTP会话测试。它支持链式请求、值捕获和响应查询,使其成为测试REST、SOAP和GraphQL API的理想选择。
作者:flykespice
发布:8小时前
链接:https://github.com/Orange-OpenSource/hurl

🔗 openmcp-sdk文档

想要成为贡献者?

点击这里了解如何为OpenMCP做出贡献。

加入我们的社区

TODO

功能路线图

模块特性优先级状态修复优先级
all完成基本基础设施完整版100%完成
render支持聊天模式中的成本分析迭代100%完成
ext支持基本MCP项目管理迭代100%P0
service支持与OpenAI兼容的大型模型集成完整版100%完成
service支持自定义协议大型模型集成MVP0%P1
all支持同时调试多个MCP服务器MVP100%P0
all支持通过大型模型进行在线验证迭代100%完成
all支持保存用户的服务器调试工作迭代100%完成
render高风险操作权限确认MVP0%P1
service连接的MCP服务器热更新MVP0%P1
service系统配置的云同步MVP0%P1
all系统提示管理模块迭代100%完成
service工具级别的日志系统MVP0%P1
serviceMCP安全检查(防止提示注入等)MVP0%P1
service内置OCR字符识别迭代100%完成

项目概念

OpenMCP采用分层模块化设计。通过组装不同的模块,可以在不同平台上实现不同的模式。

flowchart TD
    subgraph OpenMCP核心组件
        renderer[渲染器]
        openmcpservice[OpenMCP服务]
    end

    subgraph OpenMCP_Web["OpenMCP Web"]
        renderer
        openmcpservice
        nginx[Nginx]
    end

    subgraph OpenMCP_Plugin["OpenMCP 插件"]
        renderer
        openmcpservice
        vscode[VSCode 插件代码]
    end

    subgraph OpenMCP_App["OpenMCP 应用"]
        renderer
        openmcpservice
        electron[Electron 代码]
    end

    subgraph QQBot["基于OpenMCP的QQ机器人"]
        lagrange[Lagrange.OneBot]
        openmcpservice
    end

    %% 依赖关系
    OpenMCP_Web -->|前端渲染| renderer
    OpenMCP_Web -->|后端服务| openmcpservice
    OpenMCP_Web -->|反向代理| nginx

    OpenMCP_Plugin -->|UI界面| renderer
    OpenMCP_Plugin -->|核心逻辑| openmcpservice
    OpenMCP_Plugin -->|IDE集成| vscode

    OpenMCP_App -->|前端UI| renderer
    OpenMCP_App -->|本地服务| openmcpservice
    OpenMCP_App -->|桌面打包| electron

    QQBot -->|协议适配| lagrange
    QQBot -->|业务逻辑| openmcpservice

开发

  • renderer : 前端UI定义
  • service : 测试渲染器组件,包括一个简单的转发层
  • src : VSCode插件定义

渲染器和服务开发

flowchart LR
D[渲染器] <--> A[开发服务器] 
<--ws--> B[服务]
B <--mcp--> m(MCP 服务器)

项目设置:

npm run setup

启动开发服务器:

npm run serve

扩展开发

flowchart LR
D[渲染器] <--> A[extention.ts] <--> B[服务]
B <--mcp--> m(MCP 服务器)

构建用于部署:

npm run build

构建VSCode扩展:

npm run build:plugin

然后只需按F5,いただきます(让我们开始吧)


CI流水线

✅ npm run build ✅ npm run build:task-loop ✅ openmcp-client UT ✅ openmcp-sdk UT ✅ vscode扩展UT