关键词

Odoo会计审计Claude数据分析

使用说明

项目简介

本项目是一个实验性的Model Context Protocol (MCP) 服务器，专注于将Odoo会计系统的数据以标准化的方式提供给AI工具，例如Claude Desktop。它允许AI通过预定义的工具查询和分析Odoo中的会计凭证数据，主要用于审计目的。虽然当前版本侧重于会计凭证，但未来可能扩展到其他会计数据，如发票等。

主要功能点

  • 安全连接Odoo: 通过环境变量或配置文件安全地连接到您的Odoo实例。
  • 会计数据工具: 提供专门设计的工具，用于高效地搜索和检索相关的会计信息。
  • 兼容Claude AI: 完全遵循Model Context Protocol，确保与Claude Desktop等MCP客户端的无缝集成。
  • RESTful API: 通过FastAPI提供简洁的RESTful API接口，方便服务器的扩展和管理 (虽然主要作为MCP服务器使用，但也提供了RESTful endpoint 作为示例).
  • 灵活配置: 可以通过Claude Desktop的配置文件轻松配置服务器的启动和Odoo连接信息。

安装步骤

  1. 克隆仓库

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

  2. 配置环境变量 在项目根目录下创建 '.env' 文件，并填入您的Odoo连接信息：

    ODOO_URL=http://您的Odoo地址:8069
ODOO_DB=您的Odoo数据库名
ODOO_USERNAME=您的Odoo用户名
ODOO_PASSWORD=您的Odoo密码

    请替换 'http://您的Odoo地址:8069'、'您的Odoo数据库名'、'您的Odoo用户名' 和 '您的Odoo密码' 为您实际的Odoo实例信息。

  3. 创建并激活虚拟环境 (推荐)

    python -m venv .venv

    激活虚拟环境：

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

  4. 安装依赖

    python -m pip install -r requirements.txt

服务器配置 (Claude Desktop)

当您使用 Claude Desktop 等 MCP 客户端时，无需手动运行MCP服务器。您需要在 MCP 客户端的配置文件中指定服务器的启动方式。对于 Claude Desktop，您需要编辑 'claude_desktop_config.json' 文件，添加或修改 'mcpServers' 部分，配置如下：

{
  "mcpServers": {
    "odoo_accounting": {  // 服务器名称，您可以自定义
      "command": "python",  // 启动服务器的命令，这里使用 python
      "cwd": "/path/to/odoo-accounting-mcp", // MCP服务器代码库的绝对路径，请替换为您的实际路径
      "args": ["main.py"],   // 启动命令的参数，这里是运行 main.py 文件
      "env": {              // 环境变量配置
        "ODOO_URL": "http://您的Odoo地址:8069", // 您的Odoo地址
        "ODOO_DB": "您的Odoo数据库名",    // 您的Odoo数据库名
        "ODOO_USERNAME": "您的Odoo用户名",   // 您的Odoo用户名
        "ODOO_PASSWORD": "您的Odoo密码"    // 您的Odoo密码
      }
    }
  }
}

配置说明:

  • 'odoo_accounting': 您为该MCP服务器自定义的名称，在Claude Desktop中引用时会用到。
  • 'command': 启动服务器的可执行命令，通常是 'python'。
  • 'cwd': 必须修改为 您克隆的 'odoo-accounting-mcp' 仓库在您电脑上的绝对路径。例如，如果您将仓库克隆到 'D:/projects/odoo-accounting-mcp'，则 'cwd' 应设置为 '"D:/projects/odoo-accounting-mcp"' (Windows) 或 '/home/用户名/projects/odoo-accounting-mcp' (Linux/macOS)。
  • 'args': 启动命令的参数，指定要运行的Python脚本，这里是 '["main.py"]'。
  • 'env': 环境变量配置，用于传递Odoo连接信息。您需要将 'ODOO_URL', 'ODOO_DB', 'ODOO_USERNAME', 'ODOO_PASSWORD' 替换为您的实际Odoo实例信息。

请确保 'cwd' 路径配置正确，并且环境变量中的Odoo连接信息与您的Odoo实例匹配。配置完成后，Claude Desktop 将能够管理该MCP服务器的生命周期并与之通信。

基本使用方法

配置完成后，在 Claude Desktop 中，您应该能够发现名为 "Odoo MCP Server" 的 MCP 服务器及其提供的工具。目前，该服务器提供了一个名为 'get_recent_journal_entries' 的工具，允许您查询最近的会计凭证。您可以指示 Claude 调用此工具，并根据工具的描述和参数 (如 'start_date', 'end_date', 'limit') 来获取所需的会计数据，用于审计或其他分析目的。

例如，您可以向 Claude 提问： "使用 Odoo MCP Server 的工具 'get_recent_journal_entries' 获取最近 20 条会计凭证信息。" Claude 应该能够识别并调用该工具，然后将结果返回给您。

信息

分类

商业系统

访问项目