Omni Server

🚀 Omni Server

Omni Server は、Model Context Protocol (MCP) に基づくサーバー実装です。開発者が MCP フレームワークに慣れるのを支援することを目的としています。このサーバーは、MCP ベースのアプリケーションの理解と実装に役立つ基礎的なツールです。

✨ 主な機能

• 🚀 Python で実装された MCP サーバー
• 📁 モジュール化されたプロジェクト構造で、データファイル、プロンプトテンプレート、ツール、リソースが明確に分離されています。
• ⚙️ .env と Poetry を使用した柔軟な設定が可能です。
• 🧠 Claude Desktop とのシームレスな統合がサポートされています。

📚 プロジェクト構造

omni-server/
├── data/           # データファイルとデータセット
├── prompts/        # プロンプトテンプレートと関連ファイル
├── resources/      # 静的リソースとアセット
├── tools/          # ツールスクリプトとユーティリティ
├── utils/          # 補助関数とツール
├── .env            # 環境変数の定義
├── .gitignore      # Git の無視ルール
├── .python-version # Python バージョンの指定
├── README.md       # プロジェクトドキュメント
├── main.py         # アプリケーションのエントリポイント
├── pyproject.toml  # プロジェクトのメタデータと依存関係
├── server.py       # サーバーの初期化と設定
└── uv.lock         # 依存関係のロックファイル

🚀 クイックスタート

前提条件

• Python 3.8 以上
• uv を使用した依存関係管理

📦 インストール

1. リポジトリをクローンする:

git clone https://github.com/abhijithk1/omni-server.git
cd omni-server

2. uv を使用して依存関係をインストールする：

uv venv
uv pip install -r requirements.txt  # requirements.txt を使用する場合

# または、より良い方法：
uv pip install -e .  # pyproject.toml を使用する場合

3. 仮想環境をアクティブ化する（必要な場合）：

source .venv/bin/activate  # macOS/Linux
.venv\Scripts\activate     # Windows

4. .env ファイルを作成する（必要な場合）：必要な環境変数を追加します。

依存関係

すべての必須パッケージは pyproject.toml で定義されています。以下のコマンドを使用してインストールできます：

uv pip install -e .

サーバーの起動

ターミナルで手動で起動するには：

uv pip install -e .  # インストール済みであることを確認
python main.py

または、仮想環境を使用する場合は：

.venv/Scripts/python.exe main.py

💻 使用例

🧩 Claude Desktop との統合

このサーバーを Claude Desktop と統合するには、claude_desktop_config.json を以下のように設定します：

{
  "mcpServers": {
    "omni_server": {
      "command": "<プロジェクトパス>/.venv/Scripts/python.exe",
      "args": [
        "<プロジェクトパス>/main.py"
      ],
      "cwd": "<プロジェクトパス>"
    }
  }
}

以下の点を確認してください：

• Python 実行ファイルのパスが正しいこと
• 仮想環境 (.venv) が作成され、uv を使用してインストールされていること
• Claude Desktop が MCP サーバーを認識できること

設定が完了すると、Omni Server は Claude Desktop のバックエンドとして動作し、MCP プロトコルをサポートします！

貢献

貢献を歓迎します！ リポジトリをフォークし、変更を加えて Pull Request を送信してください。

📄 ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています。詳細については、LICENSE ファイルを参照してください。