Openmcp Client

OpenMCP

MCP サーバーのデバッグに使える、vscode／trae／cursor 向けのオールインワンプラグインです。

👆 全編動画

openmcpent

Inspector と MCP クライアントの基本機能を統合し、開発とテストを一つにまとめます。

さまざまなツールを使って、MCP のツール、プロンプト、リソースをテストできます。

テスト済みのツールは、「インタラクティブテスト」モジュールに配置し、LLM との対話テストに使用できます。

プロジェクトレベルの管理パネルを完備し、プロジェクト単位と全体の両方で MCP プロジェクトを簡単に管理できます。

DeepSeek、OpenAI、Qwen、Gemini、Grok、Mistral、MiniMax、Groq、Perplexity、Kimi、Ollama、OpenRouter など、複数の LLM に対応しています。

XML モードと、ツール選択用のカスタムオプションに対応しています。

openmcp-sdk

openmcpent ですべてのテストと検証が完了したら、openmcp-sdk を使って、MCP をエージェントアプリとしてすばやく簡単にデプロイできます。

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-sdk のドキュメント

コントリビューターになりませんか？

こちらをクリックして、OpenMCP への貢献方法をご確認ください。

コミュニティに参加する

• メール：[email protected]
• QQ：782833642
• Wechat：lstmkirigaya に連絡
• Discord：https://discord.gg/SKTZRf6NzU

TODO

機能ロードマップ

モジュール	機能	優先度	ステータス	修正優先度
all	基本インフラを完成させる	Full Version	100%	Done
render	チャットモードでのコスト分析に対応	Iteration	100%	Done
ext	基本的な MCP プロジェクト管理に対応	Iteration	100%	P0
service	OpenAI 互換のカスタム LLM 連携に対応	Full Version	100%	Done
service	カスタムプロトコルによる LLM 連携に対応	MVP	0%	P1
all	複数の MCP サーバーを同時にデバッグできるよう対応	MVP	100%	P0
all	LLM によるオンライン検証に対応	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| openmcpservice

OpenMCP CLI

単一のコマンドで、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 dev

CLI コマンド

コマンド	説明
openmcp init <project-name>	新しい OpenMCP プロジェクトを初期化します
openmcp dev	開発モードを開始します（バックエンド＋フロントエンド）
openmcp dev --service-only	バックエンドサービスのみを開始します
openmcp dev --renderer-only	フロントエンドレンダラーのみを開始します
openmcp start	本番モードを開始します
openmcp update	最新バージョンに更新します

📖 CLI の詳細なドキュメント

開発

• renderer：フロントエンド UI の定義
• service：シンプルな転送レイヤーを含む、renderer 用のテストコンポーネント
• src：VSCode プラグインの定義

Renderer と Service の開発

flowchart LR
D[renderer] <--> A[Dev Server] 
<--ws--> B[service]
B <--mcp--> m(MCP Server)

プロジェクトをセットアップします。

npm run setup

開発サーバーを起動します。

npm run serve

拡張機能の開発

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

デプロイ用にビルドします。

npm run build

vscode 拡張機能をビルドします。

npm run build:plugin

あとは F5 を押すだけです。いただきます（始めましょう）。

---

CI パイプライン

✅ npm run build ✅ npm run build:task-loop ✅ openmcpent UT ✅ openmcp-sdk UT ✅ vscode extension UT