OpenMCP: All you need for MCP Development
英语| 中文
🫱 官方文件
OpenMCP QQ群
OpenMCP Discord频道
OpenMCP
用于MCP服务器调试的多功能vscode/trae/cursor插件。

👆 完整视频
openmcpent
集成Inspector+MCP客户端基本功能,将开发和测试结合在一起。

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

经过测试的工具可以放置在“交互式测试”模块中,用于大型模型交互测试。

完整的项目级管理面板,便于在项目和全球层面进行MCP项目管理。

支持多种大型模型:DeepSeek、OpenAI、Qwen、Gemini、Grok、Mistral、MiniMax、Groq、Perplexity、Kimi、Ollama、OpenRouter等。

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

openmcp sdk
一旦所有内容都经过测试和验证 openmcpent,您可以将mcp部署为代理应用程序 openmcp-sdk 快速轻松:
npm install openmcp-sdk然后只需几行代码即可部署代理
import { OmAgent } from 'openmcp-sdk/service/sdk';
// create Agent
const agent = new OmAgent();
// Load configuration, which can be automatically generated after debugging with openmcp client
agent.loadMcpConfig('./mcpconfig.json');
// Read the debugged prompt
const prompt = await agent.getPrompt('hacknews', { topn: '5' });
// Execute the task
const res = await agent.ainvoke({ messages: prompt });
console.log('⚙️ Agent Response', res);输出
[2025/6/20 20:47:31] 🚀 [crawl4ai-mcp] 1.9.1 connected
[2025/6/20 20:47:35] 🤖 Agent wants to use these tools get_web_markdown
[2025/6/20 20:47:35] 🔧 using tool get_web_markdown
[2025/6/20 20:47:39] ✓ use tools success
[2025/6/20 20:47:46] 🤖 Agent wants to use these tools get_web_markdown, get_web_markdown, get_web_markdown
[2025/6/20 20:47:46] 🔧 using tool get_web_markdown
[2025/6/20 20:47:48] ✓ use tools success
[2025/6/20 20:47:48] 🔧 using tool get_web_markdown
[2025/6/20 20:47:54] ✓ use tools success
[2025/6/20 20:47:54] 🔧 using tool get_web_markdown
[2025/6/20 20:47:57] ✓ use tools success
⚙️ Agent Response
⌨️ Today's Tech Article Roundup
📌 How to Detect or Observe Passing Gravitational Waves?
Summary: This article explores the physics of gravitational waves, explaining their effects on space-time and how humans might perceive or observe this cosmic phenomenon.
Author: ynoxinul
Posted: 2 hours ago
Link: https://physics.stackexchange.com/questions/338912/how-would-a-passing-gravitational-wave-look-or-feel
📌 Learn Makefile Tutorial
Summary: A comprehensive Makefile tutorial for beginners and advanced users, covering basic syntax, variables, automatic rules, and advanced features to help developers manage project builds efficiently.
Author: dsego
Posted: 4 hours ago
Link: https://makefiletutorial.com/
📌 Hurl: Run and Test HTTP Requests in Plain Text
Summary: Hurl is a command-line tool that allows defining and executing HTTP requests in plain text format, ideal for data fetching and HTTP session testing. It supports chained requests, value capture, and response queries, making it perfect for testing REST, SOAP, and GraphQL APIs.
Author: flykespice
Posted: 8 hours ago
Link: https://github.com/Orange-OpenSource/hurl想成为一名贡献者吗?
点击 这里 学习如何为OpenMCP做出贡献。
加入我们的社区
- 电子邮件: zhelonghuang@qq.com
- QQ:782833642
- 微信:联系方式
lstmkirigaya - 不一致:https://discord.gg/SKTZRf6NzU
待办事项
功能路线图
| 模块 | 功能 | 优先级 | 状态 | 修复优先级 |
|---|---|---|---|---|
all | 完善的基础设施 | Full Version | 100% | Done |
render | 聊天模式下的支持成本分析 | Iteration | 100% | Done |
ext | 支持基本的MCP项目管理 | Iteration | 100% | P0 |
service | 支持自定义OpenAI兼容的大模型集成 | Full Version | 100% | Done |
service | 支持自定义协议大模型集成 | MVP | 0% | P1 |
all | 支持同时调试多个MCP服务器 | MVP | 100% | P0 |
all | 支持通过大型模型进行在线验证 | Iteration | 100% | Done |
all | 支持节省用户的服务器调试工作 | Iteration | 100% | Done |
render | 高风险作业许可确认 | MVP | 0% | P1 |
service | 连接的MCP服务器的热更新 | MVP | 0% | P1 |
all | 系统提示管理模块 | Iteration | 100% | Done |
service | 智能测井系统 | MVP | 0% | P1 |
service | MCP安全检查(防止及时注射等) | MVP | 0% | P1 |
service | 内置OCR用于字符识别 | Iteration | 100% | Done |
项目概念
OpenMCP采用分层模块化设计。通过组装不同的模块,可以在不同的平台上以不同的模式实现。
flowchart TD
subgraph OpenMCP Core Components
renderer[Renderer]
openmcpservice[OpenMCPService]
end
subgraph OpenMCP_Web["OpenMCP Web"]
renderer
openmcpservice
nginx[Nginx]
end
subgraph OpenMCP_Plugin["OpenMCP Plugin"]
renderer
openmcpservice
vscode[VSCode Plugin Code]
end
subgraph OpenMCP_App["OpenMCP App"]
renderer
openmcpservice
electron[Electron Code]
end
subgraph QQBot["OpenMCP-based QQ Bot"]
lagrange[Lagrange.OneBot]
openmcpservice
end
%% Dependencies
OpenMCP_Web -->|Frontend Rendering| renderer
OpenMCP_Web -->|Backend Service| openmcpservice
OpenMCP_Web -->|Reverse Proxy| nginx
OpenMCP_Plugin -->|UI Interface| renderer
OpenMCP_Plugin -->|Core Logic| openmcpservice
OpenMCP_Plugin -->|IDE Integration| vscode
OpenMCP_App -->|Frontend UI| renderer
OpenMCP_App -->|Local Service| openmcpservice
OpenMCP_App -->|Desktop Packaging| electron
QQBot -->|Protocol Adaptation| lagrange
QQBot -->|Business Logic| openmcpserviceOpenMCP命令行界面
只需一个命令即可快速设置和运行OpenMCP开发环境:
# Install CLI globally
npm install -g @agent-ruler/openmcp
# Create a new project
openmcp init my-project
cd my-project
# Start development servers (service + renderer)
openmcp devCLI命令
| 命令 | 描述 |
|---|---|
| `openmcp init | |
| ` | 初始化新的OpenMCP项目 |
openmcp dev | 启动开发模式(后端+前端) |
openmcp dev --service-only | 仅启动后端服务 |
openmcp dev --renderer-only | 仅启动前端渲染器 |
openmcp start | 启动生产模式 |
openmcp update | 更新到最新版本 |
发展
- 渲染器:前端UI定义
- 服务:测试渲染器的组件,包括一个简单的转发层
- src:VSCode插件定义
渲染器和服务开发
flowchart LR
D[renderer] A[Dev Server]
B[service]
B m(MCP Server)项目设置:
npm run setup启动开发服务器:
npm run serve扩展开发
flowchart LR
D[renderer] A[extention.ts] B[service]
B m(MCP Server)部署构建:
npm run build构建vscode扩展:
npm run build:pluginThen just press F5,我开动了
______________________________________________________________________
CI管道
✅ npm 运行构建 ✅ npm运行构建:任务循环 ✅ 开放式UT ✅ openmcp sdk UT ✅ vscode扩展UT
