Simple Tool Server

MCPoSimpleServer

Model Context Protocol（MCP）を実装した、Python ベースの LLM サーバーです。

🤔 MCPoSimpleServer とは？

MCPoSimpleServer は、MCP ツールを分離された安全な環境で実行・管理するための、軽量な非同期 API プラットフォームです。LLM アプリケーションとシームレスに連携できるよう、Model Context Protocol（MCP）を実装しています。

📺 デモ

MCPoSimpleServer の動作を紹介するデモ動画をご覧ください。

✨ 主な機能

• ✨ ローカル Docker コンテナ – 単一の SSE-MCP 接続で使用できる独自のローカル Docker コンテナ
• ⚡ uvx または npx で起動する MCP ツールを、すばやく簡単に読み込めます
• 🔄 ツールの動的な読み込みとフィルタリング（ホワイトリスト／ブラックリスト）
• 🌐 SSE、Swagger REST、OpenAPI.json を介して MCP ツールにアクセスできます（OpenWebUI と互換性があります）
• 🐳 ツールの分離 – 各ツールは独自のスレッドで実行されます
• 🗄️ JSON ベースの設定 – 編集が簡単で、移植性に優れています
• 🧑‍💻 独自の MCP サーバーをカスタム ENV パラメーターで起動できます
• 🛡️ Bearer 管理者ハック – シンプルな管理者認証（テストや迅速な変更に最適です）
• 📝 コードの明瞭さと安全性を高める、完全な型ヒント付きの非同期 FastAPI Python サーバー
• ✅ PyTest – 実行中のサーバー上で変更をすばやく簡単に検証できます

🎉 現在の機能

• 🔗 FastAPI／Python 3.13 サーバーを搭載した Debian 13 ベースの Docker コンテナ
• ⚡ uvx または npx で起動する MCP ツールを、すばやく簡単に読み込めます
• 🌐 SSE、Swagger REST、OpenAPI.json を介して MCP ツールにアクセスできます（OpenWebUI と互換性があります）
• 🆒 ENV で制御する SupervisorD により、SSHD + Xfce + noVNC を実行できます（Web 経由のデスクトップ／ポート 6901、約 260MB）
• 🔄 MCP サーバーからのツールの動的な読み込みとフィルタリング（ホワイトリスト／ブラックリスト）
• 🧵 各 MCP サーバーは独自のスレッドで実行されます
• 🗄️ データベースは不要 – 編集や移植が簡単な JSON 設定を使用します
• 🧑‍💻 ユーザーはカスタム ENV を指定して独自の MCP サーバーを定義できます（Auth Bearer により自動検出）
• 🛡️ Env Bearer 管理者ハック – Bearer 管理者を模擬するよう設定可能な env（テストや迅速な変更に最適です）
• 📝 コードの明瞭さと安全性を高めるため、FastAPI Python + Pydantic のみで構築しています
• ❌ FastAPI のみに基づくカスタム SSE スタック（Starlette は使用しません）
• ✅ PyTest – モックを使わず、実際に稼働するサーバーインスタンスでテストを実行します

🚀 開発中

• 🤔 プロンプト – SSE へのクラス注入に関するバグを修正中です
• 🖥️ マーケットプレイス付き WebUI フロントエンド（クリックしてインストール）