MCP Server Of9

🚀 MCP サーバー

このサーバーは、モデルコンテキストプロトコル（MCP）を実装しており、AIエージェントや大規模言語モデル（LLM）に様々なツールを提供します。具体的には、SearXNGを介したウェブ検索機能やファイルシステム操作などが含まれます。

✨ 主な機能

• ウェブ検索：SearXNGを使用して、カスタムパラメータでウェブ検索を実行します。
• ファイルシステム操作：ファイルの読み取り、書き込み、管理を行い、セキュリティ制御付きです。
• 拡張可能なアーキテクチャ：MCPプロトコルに準拠したカスタムツールの追加をサポートします。
• Dockerサポート：サーバーと関連サービスをDockerで実行することを推奨します。

📦 インストール

インストール要件

• Python 3.13以上のバージョン
• uv パッケージマネージャー（直接インストール時に使用）

Dockerを使用したインストール（推奨）

# Dockerイメージのビルド
docker build -t mcp-server .

# サーバーとSearXNGサービスの起動
docker-compose up

直接インストール

# Python 3.13がインストールされていることを確認
python --version  # Python 3.13.x のような表示がされるはず
# uvのインストール（未インストールの場合）
pip install uv
# 仮想環境の作成と依存関係のインストール
uv venv --python=python3.13
uv install
# サーバーの起動
python -m mcp_server start --config config.env

💻 使用例

基本的な使用法

# 組み込みのMCPサーバーインスタンスを使用
from mcp_server.server import mcp

@mcp.tool()
def my_custom_tool(param1: str, param2: int = 10) -> dict:
    """私のカスタムツールの説明"""
    # ツールの機能を実装
    return {"result": f"Processed {param1} with {param2}"}

高度な使用法

現代的なクライアントの使用例

from mcp_client.session import ClientSession

# クライアントセッションの初期化
session = ClientSession('http://localhost:8000')

# ツールの呼び出し
response = session.call_tool('my_custom_tool', param1='test')
print(response)

シンプルなクライアントの使用例

import requests

# サーバーAPIを直接呼び出す
url = 'http://localhost:8000/api'
data = {
    'tool': 'my_custom_tool',
    'params': {'param1': 'test'}
}
response = requests.post(url, json=data)
print(response.json())

📚 ドキュメント

ツールの説明

• ウェブ検索：SearXNGを通じて、効率的かつ安全なウェブ検索を実現します。
• ファイルシステム操作：ファイルの読み取り、書き込み、削除操作をサポートし、権限制御付きです。
• 拡張性：新しいMCPプロトコルツールやサービスを簡単に統合できます。

環境変数の設定

# 設定ファイルのサンプル内容
MCP_SERVER__HOST=0.0.0.0
MCP_SERVER__PORT=8000
MCP_SEARXNG__INSTANCE_URL=http://localhost:8080/

クライアントの例

• examples/ ディレクトリにはクライアントの例が含まれています。
  • examples/client.py：ClientSession APIを使用する現代的なクライアント
  • examples/simple_client.py：APIを直接呼び出すシンプルなクライアント

拡張開発

クイックMCP方法を使用した拡張

from mcp_server.server import mcp

@mcp.tool()
def my_custom_tool(param1: str, param2: int = 10) -> dict:
    """私のカスタムツールの説明"""
    # ツールの機能を実装
    return {"result": f"Processed {param1} with {param2}"}

ネイティブアーキテクチャを使用した拡張

開発者ガイドを参照して、ネイティブアーキテクチャを使用してカスタムツールを追加する方法を学んでください。

📄 ライセンス

このプロジェクトはMIT Licenseに準拠しています。詳細はLICENSEファイルを参照してください。

謝辞

• モデルコンテキストプロトコル はプロトコルの仕様を提供しています。
• SearXNG は検索機能の実装を提供しています。