Omni Server

Omni Server

Omni Server は、開発者が MCP フレームワークに慣れるための Model Context Protocol（MCP）サーバーです。MCP ベースのアプリケーションを理解し、実装するための基盤となるツールとして機能します。

---

特徴

• 🚀 Python を使用した MCP サーバーの実装
• 📁 プロンプト、ツール、データ、リソースを明確に分離したモジュール式のプロジェクト構成
• ⚙️ .env と Poetry を使用して簡単に設定可能
• 🧠 Claude Desktop とシームレスに連携するよう設計

---

プロジェクト構成

omni-server/
├── data/           # Data files and datasets
├── prompts/        # Prompt templates and related files
├── resources/      # Static resources and assets
├── tools/          # Utility scripts and tools
├── utils/          # Helper functions and utilities
├── .env            # Environment variable definitions
├── .gitignore      # Git ignore rules
├── .python-version # Python version specification
├── README.md       # Project documentation
├── main.py         # Main application entry point
├── pyproject.toml  # Project metadata and dependencies
├── server.py       # Server initialization and configuration
└── uv.lock         # Dependency lock file

---

はじめに

前提条件

• 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  # if using requirements.txt

# or, better:
uv pip install -e .  # if pyproject.toml is used

3. 必要に応じて仮想環境を有効にします：

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

4. 必要に応じて、必要な環境変数を記述した .env ファイルを作成します。

---

依存関係

必要なパッケージはすべて pyproject.toml で定義されています。次のコマンドでインストールできます：

uv pip install -e .

---

サーバーの起動

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

uv pip install -e .  # ensure it's installed
python main.py

または、仮想環境を使用している場合：

.venv/Scripts/python.exe main.py

---

🧩 Claude Desktop との連携

このサーバーを Claude Desktop で使用するには、claude_desktop_config.json を次のように設定します：

{
  "mcpServers": {
    "omni_server": {
      "command": "<PATH TO PROJECT>/.venv/Scripts/python.exe",
      "args": [
        "<PATH TO PROJECT>/main.py"
      ],
      "cwd": "<PATH TO PROJECT>"
    }
  }
}

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

• Python 実行ファイルへのパスが正しいこと
• 仮想環境（.venv）が作成され、uv を使用してインストールされていること
• Claude Desktop が MCP サーバーを認識するように設定されていること

設定が完了すると、Omni Server は Claude Desktop 内で MCP 互換のバックエンドとして実行されます！

---

コントリビューション

コントリビューションを歓迎します！リポジトリをフォークして変更を加え、プルリクエストを作成してください。

---

ライセンス

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