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 快速轻松：```bash
npm install openmcp-sdk

然后只需几行代码即可部署代理```typescript
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-sdk文档

## 想成为一名贡献者吗？

点击 这里 学习如何为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采用分层模块化设计。通过组装不同的模块，可以在不同的平台上以不同的模式实现。```mermaid
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| openmcpservice

OpenMCP命令行界面

只需一个命令即可快速设置和运行OpenMCP开发环境：```bash

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 dev

### CLI命令

|命令|描述|
|---------|-------------|
| `openmcp init ` |初始化新的OpenMCP项目|
| `openmcp dev` |启动开发模式（后端+前端）|
| `openmcp dev --service-only` |仅启动后端服务|
| `openmcp dev --renderer-only` |仅启动前端渲染器|
| `openmcp start` |启动生产模式|
| `openmcp update` |更新到最新版本|

📖 完整CLI文档

## 发展

- 渲染器：前端UI定义
- 服务：测试渲染器的组件，包括一个简单的转发层
- src:VSCode插件定义

### 渲染器和服务开发```mermaid
flowchart LR
D[renderer] <--> A[Dev Server]
<--ws--> B[service]
B <--mcp--> m(MCP Server)

项目设置：```bash
npm run setup

启动开发服务器：```bash
npm run serve

扩展开发```mermaid

flowchart LR
D[renderer] <--> A[extention.ts] <--> B[service]
B <--mcp--> m(MCP Server)

部署构建：```bash
npm run build

构建vscode扩展：bash npm run build:plugin

Then just press F5,我开动了

CI管道

✅ npm 运行构建
✅ npm运行构建：任务循环
✅ 开放式UT
✅ openmcp sdk UT
✅ vscode扩展UT