Omni Server

🚀 Omni Server

Omni Server 是一個基於 Model Context Protocol (MCP) 的服務器實現，旨在幫助開發者熟悉 MCP 框架。它作為基礎工具，為理解和實施基於 MCP 的應用程序提供支持。

✨ 主要特性

• 🚀 採用 Python 實現的 MCP 服務器。
• 📁 項目結構模塊化，數據文件、提示模板、工具和資源清晰分離。
• ⚙️ 支持通過 .env 和 Poetry 進行靈活配置。
• 🧠 與 Claude Desktop 實現無縫集成。

📦 安裝指南

前提條件

• 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 文件（如果有需要），添加任何必要的環境變量。

💻 使用示例

運行服務器

手動運行

要在終端手動運行：

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 協議！

📚 詳細文檔

項目結構

omni-server/
├── data/           # 數據文件和數據集
├── prompts/        # 提示模板及相關文件
├── resources/      # 靜態資源和資產
├── tools/          # 工具腳本和實用程序
├── utils/          # 輔助函數和工具
├── .env            # 環境變量定義
├── .gitignore      # Git 忽略規則
├── .python-version # Python 版本指定
├── README.md       # 項目文檔
├── main.py         # 應用程序入口點
├── pyproject.toml  # 項目元數據和依賴項
├── server.py       # 服務器初始化和配置
└── uv.lock         # 依賴鎖定文件

依賴項

所有必需的包都定義在 pyproject.toml 中。可以使用以下命令安裝：

uv pip install -e .

🤝 貢獻

歡迎貢獻！ Fork 倉庫，在上面進行更改並提交 Pull Request。

📄 許可證

此項目 licensed under the MIT License。有關詳細信息，請參閱 LICENSE 文件。