🧾 Odoo会计MCP服务器

这是一个简化版的、非生产就绪的模型上下文协议（MCP）服务器，旨在通过XML-RPC与Odoo会计进行实验性集成。该项目特别针对使用Claude Desktop，专注于使AI工具能够查询和分析用于审计目的的账簿条目。虽然它允许与Odoo会计数据交互，但其当前范围仅限于这一特定用例，并不适用于生产环境。未来可能会考虑扩展到其他与会计相关的数据，如发票等，具体取决于初始关注点的结果。

---

🔧 示例：Claude检测MCP工具

🚀 主要特性

• 安全连接Odoo实例：使用环境变量或专用配置文件建立与您的Odoo实例的安全连接。
• 会计数据工具：提供专门工具以高效搜索和检索相关会计信息。
• 兼容Claude AI：完全符合模型上下文协议，确保与Claude Desktop的顺畅集成。
• RESTful API（通过FastAPI）：提供一个简单而强大的FastAPI服务器来暴露RESTful端点。
• 灵活配置：通过Claude Desktop的配置设置轻松配置服务器。

---

🛠️ 安装指南

按照以下步骤设置并运行Odoo会计MCP服务器：

1. 克隆仓库

git clone https://github.com/your-username/odoo-accounting-mcp.git
cd odoo-accounting-mcp

2. 配置环境变量

在项目根目录创建一个.env文件，并填充您的Odoo连接详情：

ODOO_URL=http://localhost:8069
ODOO_DB=your_db_name
ODOO_USERNAME=your_odoo_user_name
ODOO_PASSWORD=your_odoo_password

3. 设置虚拟环境

建议使用虚拟环境来管理项目依赖：

python -m venv .venv

激活它：

.\.venv\Scripts activate

4. 安装依赖

从requirements.txt文件安装所需的Python包：

python -m pip install -r requirements.txt

5. 运行服务器

使用主Python脚本启动MCP服务器：

python main.py

服务器通常会在http://localhost:8000启动并可访问。

---

⚙️ Claude Desktop集成

当使用Claude Desktop时，无需手动运行MCP服务器。相反，配置Claude Desktop来管理服务器生命周期。

更新您的claude_desktop_config.json文件，添加以下配置（根据需要调整路径和Odoo凭据）：

{
  "mcpServers": {
    "odoo": {
      "command": "python",
      "cwd": "D:/jeevan-projects/odoomcp/odoo_account_mcp",
      "args": ["main.py"],
      "env": {
        "ODOO_URL": "http://localhost:8069",
        "ODOO_DB": "your_db",
        "ODOO_USERNAME": "admin",
        "ODOO_PASSWORD": "your_password"
      }
    }
  }
}

重要提示：

• 确保配置中的cwd路径指向您的odoo_account_mcp项目的正确目录。
• 使用实际的Odoo实例详情替换占位符Odoo凭据。

---

📜 许可证

本项目采用MIT许可证。