Omni Server

Omni Server

Omni Server 是一个模型上下文协议（MCP）服务，旨在帮助开发者熟悉 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 的后端运行！

---

贡献

欢迎贡献！请 Fork 仓库、进行修改并提交拉取请求。

---

许可证

本项目采用 MIT 许可证。详情请参阅 LICENSE 文件。