1MCP - すべての人のための1つのMCPサーバー
複数の MCP サーバーを 1 つに集約する統合モデル コンテキスト プロトコル サーバー実装。
概要
1MCP（One MCP）は、AIアシスタントの活用を簡素化するように設計されています。異なるクライアント（Claude Desktop、Cherry Studio、Cursor、Roo Code、Claudeなど）ごとに複数のMCPサーバーを構成する代わりに、1MCPは単一の統合サーバーを提供します。これにより、以下のことが可能になります。
複数のMCPサーバーを1つの統合インターフェースに集約します
冗長なサーバーインスタンスを排除することでシステムリソースの使用量を削減します
さまざまなAIアシスタント間の構成管理を簡素化
AIモデルが外部ツールやリソースと対話するための標準化された方法を提供します
サーバーの再起動なしで動的な構成の再読み込みをサポート
正常なシャットダウンとリソースのクリーンアップを処理します
Related MCP server: MCP Starter
クイックスタート
Cursor が Claude Desktop で既に構成されている既存の MCP サーバーを使用できるようにするには、次の手順に従います。
Claude Desktop 構成ファイルを使用して 1MCP サーバーを実行します。
npx -y @1mcp/agent --config ~/Library/Application\ Support/Claude/claude_desktop_config.json
1MCP サーバーをカーソル設定ファイル ( ~/.cursor/mcp.json ) に追加します。
{
"mcpServers": {
"1mcp": {
"type": "http",
"url": "http://localhost:3050/sse"
}
}
}
楽しめ！
使用法
npxを使用してサーバーを直接実行できます。
# Basic usage (starts server with SSE transport)
npx -y @1mcp/agent
# Use existing Claude Desktop config
npx -y @1mcp/agent --config ~/Library/Application\ Support/Claude/claude_desktop_config.json
# Use stdio transport instead of SSE
npx -y @1mcp/agent --transport stdio
# Show all available options
npx -y @1mcp/agent --help
利用可能なオプション:
--transport, -t : トランスポートタイプを選択します ("stdio" または "http"、デフォルト: "http")
--config, -c : 特定の設定ファイルを使用する
--port, -P : HTTP ポートを変更する (デフォルト: 3050)
--host, -H : HTTPホストを変更する（デフォルト: localhost）
--tags, -g : タグでサーバーをフィルタリングします（以下のタグのセクションを参照）
--help, -h : ヘルプを表示
環境変数を使用した例:
# Using environment variables
ONE_MCP_PORT=3051 ONE_MCP_TAGS=network,filesystem npx -y @1mcp/agent
# Or in your shell configuration
export ONE_MCP_PORT=3051
export ONE_MCP_TAGS=network,filesystem
npx -y @1mcp/agent
ドッカー
Docker を使用して 1MCP を実行することもできます。
# Pull the latest image
docker pull ghcr.io/1mcp-app/agent:latest
# Run with HTTP transport (default)
docker run -p 3050:3050 ghcr.io/1mcp-app/agent
# Run with a custom config file
docker run -p 3050:3050 -v /path/to/config.json:/config.json ghcr.io/1mcp-app/agent --config /config.json
# Run with stdio transport
docker run -i ghcr.io/1mcp-app/agent --transport stdio
利用可能な画像タグ:
環境変数
ONE_MCP_というプレフィックスが付いた環境変数を使用して 1MCP を設定できます。
ONE_MCP_TRANSPORT : トランスポートタイプ ("stdio" または "http"、デフォルト: "http")
ONE_MCP_PORT : HTTP ポート (デフォルト: 3050)
ONE_MCP_HOST : HTTPホスト（デフォルト: "localhost"）
ONE_MCP_CONFIG : 設定ファイルへのパス
ONE_MCP_TAGS : サーバーをフィルタリングするためのタグのカンマ区切りリスト
環境変数を使用した例:
docker run -p 3051:3051 \
-e ONE_MCP_PORT=3051 \
-e ONE_MCP_TAGS=network,filesystem \
ghcr.io/1mcp-app/agent
タグを理解する
タグは、どのMCPサーバーをどのクライアントで利用できるかを制御するのに役立ちます。タグは、各サーバーの機能を説明するラベルのようなものです。
タグの使い方
サーバー設定で、各サーバーの機能を説明するタグを追加します。
{
"mcpServers": {
"web-server": {
"command": "uvx",
"args": ["mcp-server-fetch"],
"tags": ["network", "web"],
"disabled": false
},
"file-server": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "~/Downloads"],
"tags": ["filesystem"],
"disabled": false
}
}
}
1MCPをstdioモードで起動する場合: タグでサーバーをフィルタリングできます
# Only start servers with the "network" tag
npx -y @1mcp/agent --transport stdio --tags "network"
# Start servers with either "network" or "filesystem" tags
npx -y @1mcp/agent --transport stdio --tags "network,filesystem"
SSEトランスポートを使用する場合：クライアントは特定のタグを持つサーバーをリクエストできます
{
"mcpServers": {
"1mcp": {
"type": "http",
"url": "http://localhost:3050/sse?tags=network" // Only connect to network-capable servers
}
}
}
タグの例:
network : Webリクエストを行うサーバー用
filesystem : ファイル操作を扱うサーバー用
memory : メモリ/ストレージを提供するサーバーの場合
shell : シェルコマンドを実行するサーバー用
db : データベース操作を処理するサーバー用
構成
グローバル構成
サーバーは、グローバルな場所で構成を自動的に管理します。
設定ファイルの形式
{
"mcpServers": {
"mcp-server-fetch": {
"command": "uvx",
"args": [
"mcp-server-fetch"
],
"disabled": false
},
"server-memory": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-memory"
],
"disabled": false
}
}
}
仕組み
システムアーキテクチャ
graph TB
subgraph "AI Assistants"
A1[Claude Desktop]
A2[Cursor]
A3[Cherry Studio]
A4[Roo Code]
end
subgraph "1MCP Server"
MCP[1MCP Agent]
end
subgraph "MCP Servers"
S1[Server 1]
S2[Server 2]
S3[Server 3]
end
A1 -->|http| MCP
A2 -->|http| MCP
A3 -->|http| MCP
A4 -->|http| MCP
MCP --> |http| S1
MCP --> |stdio| S2
MCP --> |stdio| S3
リクエストフロー
sequenceDiagram
participant Client as AI Assistant
participant 1MCP as 1MCP Server
participant MCP as MCP Servers
Client->>1MCP: Send MCP Request
activate 1MCP
1MCP->>1MCP: Validate Request
1MCP->>1MCP: Load Config
1MCP->>MCP: Forward Request
activate MCP
MCP-->>1MCP: Response
deactivate MCP
1MCP-->>Client: Forward Response
deactivate 1MCP
発達
依存関係をインストールします:
サーバーを構築します。
自動リビルドを使用した開発の場合:
サーバーを実行します。
デバッグ
パッケージ スクリプトとして利用可能なMCP Inspectorを使用します。
インスペクターは、ブラウザでデバッグ ツールにアクセスするための URL を提供します。