mcpField
M
mcp-smart-proxy

mcp-smart-proxy

ローカル
github.com/daedalus開発ツール027 週間前に更新
リポジトリ

mcp-smart-proxy について

mcp-smart-proxyは、上流のMCPサーバーに接続するゲートウェイで、セマンティックなツール検索とトークン効率のよいアクセスを提供します。CLIからサーバー実行、インデックス作成、状態確認、検証、設定ファイル監視による実行中の更新ができます。

主な機能

  1. 01上流MCPサーバーへのゲートウェイ
  2. 02セマンティックなツール検索
  3. 03トークン効率のよいアクセス
  4. 04設定ファイルの監視による実行中の更新
  5. 05CLIでのインデックス作成、状態確認、検証

活用シーン

  1. 01設定済みMCPサーバーへのゲートウェイ提供
  2. 02セマンティック検索によるツールの発見
  3. 03監視対象の設定ファイルによる上流サーバーの更新
  4. 04プロキシ設定と状態の確認

MCP 対応

上流サーバーへのMCPゲートウェイとして動作し、ツールの検索と呼び出しを提供します。STDIOでローカルクライアントに接続でき、CLIにはstreamable HTTPトランスポートも記載されています。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "daedalus-mcp-smart-proxy": {
      "command": "uvx",
      "args": [
        "mcp-smart-proxy"
      ]
    }
  }
}
起動コマンドuvx mcp-smart-proxy

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
pypimcp-smart-proxy0.1.1

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

MCPSmartProxy

セマンティックなツール検索を備えた、トークン効率の高い MCP サーバーゲートウェイ

PyPI Python Coverage Ruff

mcp-name: io.github.daedalus/mcp-smart-proxy

インストール

pip install mcp-smart-proxy

使用方法

from mcp_smart_proxy import ProxyConfig

config = ProxyConfig.from_file("proxy.yaml")

CLI

mcp-smart-proxy --help
mcp-smart-proxy serve --config proxy.yaml
mcp-smart-proxy serve --config proxy.yaml --watch ./servers/
mcp-smart-proxy serve --config proxy.yaml --transport streamable-http --host 0.0.0.0 --port 8000
mcp-smart-proxy index --config proxy.yaml
mcp-smart-proxy status --config proxy.yaml
mcp-smart-proxy validate --config proxy.yaml

--watch オプションは、アップストリームサーバーの設定を含む .yaml、.yml、または .json ファイルがあるディレクトリを監視します。ファイルを追加、変更、または削除すると、実行時に利用可能なサーバーが動的に更新されます。

トランスポートオプション

--transport オプションで、以下を指定できます。

  • stdio（デフォルト）- ローカル MCP クライアント向けの標準入力／出力トランスポート

API

設定
  • ProxyConfig - メインの設定モデル
  • UpstreamConfig - アップストリームサーバーの設定
  • EmbeddingConfig - 埋め込みバックエンドの設定
  • VectorStoreConfig - ベクトルストアバックエンドの設定
モデル
  • ListResult - list ツールの結果
  • SearchResult - search ツールの結果
  • ToolResult - ツール呼び出しの結果

開発

git clone https://github.com/daedalus/mcp-smart-proxy.git
cd mcp-smart-proxy
pip install -e ".[test]"

# run tests
pytest

# format
ruff format src/ tests/

# lint
ruff check src/ tests/

# type check
mypy src/

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。