1MCP Server

by 1mcp-app
Verified

Integrations

  • Indicated by server-filesystem capability, which likely allows file operations on git repositories

  • Provides platform-specific configurations and file paths for Linux users

  • Provides platform-specific configurations and file paths for macOS users

1MCP - すべての人のための1つのMCPサーバー

複数の MCP サーバーを 1 つに集約する統合モデル コンテキスト プロトコル サーバー実装。

概要

1MCP(One MCP)は、AIアシスタントの活用を簡素化するように設計されています。異なるクライアント(Claude Desktop、Cherry Studio、Cursor、Roo Code、Claudeなど)ごとに複数のMCPサーバーを構成する代わりに、1MCPは単一の統合サーバーを提供します。これにより、以下のことが可能になります。

  • 複数のMCPサーバーを1つの統合インターフェースに集約します
  • 冗長なサーバーインスタンスを排除することでシステムリソースの使用量を削減します
  • さまざまなAIアシスタント間の構成管理を簡素化
  • AIモデルが外部ツールやリソースと対話するための標準化された方法を提供します
  • サーバーの再起動なしで動的な構成の再読み込みをサポート
  • 正常なシャットダウンとリソースのクリーンアップを処理します

クイックスタート

Cursor が Claude Desktop で既に構成されている既存の MCP サーバーを使用できるようにするには、次の手順に従います。

  1. Claude Desktop 構成ファイルを使用して 1MCP サーバーを実行します。
npx -y @1mcp/agent --config ~/Library/Application\ Support/Claude/claude_desktop_config.json
  1. 1MCP サーバーをカーソル設定ファイル ( ~/.cursor/mcp.json ) に追加します。
{ "mcpServers": { "1mcp": { "type": "http", "url": "http://localhost:3050/sse" } } }
  1. 楽しめ!

使用法

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" または "sse"、デフォルト: "sse")
  • --config, -c : 特定の設定ファイルを使用する
  • --port, -P : SSEポートを変更する(デフォルト: 3050)
  • --host, -H : SSEホストを変更する(デフォルト: 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 SSE 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

利用可能な画像タグ:

  • latest : 最新の安定リリース
  • vX.YZ : 特定のバージョン(例: v1.0.0
  • sha-<commit> : 特定のコミット

環境変数

ONE_MCP_というプレフィックスが付いた環境変数を使用して 1MCP を設定できます。

  • ONE_MCP_TRANSPORT : トランスポートタイプ(「stdio」または「sse」、デフォルト:「sse」)
  • ONE_MCP_PORT : SSEポート(デフォルト: 3050)
  • ONE_MCP_HOST : SSEホスト(デフォルト: "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サーバーをどのクライアントで利用できるかを制御するのに役立ちます。タグは、各サーバーの機能を説明するラベルのようなものです。

タグの使い方

  1. サーバー設定で、各サーバーの機能を説明するタグを追加します。
{ "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 } } }
  1. 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"
  1. SSEトランスポートを使用する場合:クライアントは特定のタグを持つサーバーをリクエストできます
{ "mcpServers": { "1mcp": { "type": "http", "url": "http://localhost:3050/sse?tags=network" // Only connect to network-capable servers } } }

タグの例:

  • network : Webリクエストを行うサーバー用
  • filesystem : ファイル操作を扱うサーバー用
  • memory : メモリ/ストレージを提供するサーバーの場合
  • shell : シェルコマンドを実行するサーバー用
  • db : データベース操作を処理するサーバー用

構成

グローバル構成

サーバーは、グローバルな場所で構成を自動的に管理します。

  • macOS/Linux: ~/.config/1mcp/mcp.json
  • Windows: %APPDATA%/1mcp/mcp.json

設定ファイルの形式

{ "mcpServers": { "mcp-server-fetch": { "command": "uvx", "args": [ "mcp-server-fetch" ], "disabled": false }, "server-memory": { "command": "npx", "args": [ "-y", "@modelcontextprotocol/server-memory" ], "disabled": false } } }

仕組み

システムアーキテクチャ

リクエストフロー

発達

依存関係をインストールします:

pnpm install

サーバーを構築します。

pnpm build

自動リビルドを使用した開発の場合:

pnpm watch

サーバーを実行します。

pnpm dev

デバッグ

パッケージ スクリプトとして利用可能なMCP Inspectorを使用します。

pnpm inspector

インスペクターは、ブラウザでデバッグ ツールにアクセスするための URL を提供します。

-
security - not tested
A
license - permissive license
-
quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

複数の MCP サーバーを 1 つに集約する統合モデル コンテキスト プロトコル サーバー。これにより、Claude Desktop、Cursor、Cherry Studio などの AI アシスタントが複数のインスタンスを管理する代わりに単一のサーバーに接続できるようになります。

  1. Overview
    1. Quick Start
      1. Usage
        1. Docker
          1. Environment Variables
          2. Understanding Tags
        2. Configuration
          1. Global Configuration
          2. Configuration File Format
        3. How It Works
          1. System Architecture
          2. Request Flow
        4. Development
          1. Debugging
        ID: ttsuowc5pm