Omni Server

Omni Server 是一个模型上下文协议 (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 兼容后端运行！

---

贡献

欢迎贡献！ Fork 仓库，进行更改，然后打开一个 pull request。

---

许可证

该项目根据 MIT 许可证获得许可。 有关详细信息，请参见 LICENSE 文件。