🧾 Odoo Accounting MCP Server

🧾 Odoo Accounting MCP Server

site icon
2025.04.15 1
Python会计服务AI 集成金融服务
Odoo Accounting MCP Server 是一个简化的、非生产就绪的 Model Context Protocol (MCP) 服务器,专为通过 XML-RPC 与 Odoo Accounting 进行实验性集成而设计。该项目主要针对与 Claude Desktop 的使用,专注于使 AI 工具能够查询和分析会计日记账条目以进行审计。虽然它允许与 Odoo 会计数据进行交互,但其当前范围仅限于此特定用例,并不适用于生产环境。未来可能会考虑扩展到其他与会计相关的数据,如发票,具体取决于初始重点的结果。
View on GitHub

Overview

基本能力

产品定位

Odoo Accounting MCP Server 是一个专为 Odoo Accounting 设计的实验性 MCP 服务器,主要用于通过 AI 工具查询和分析会计数据。

核心功能

  • Secure Odoo Connection: 使用环境变量或专用配置文件安全连接到 Odoo 实例。
  • Accounting Data Tools: 提供专门工具以高效搜索和检索相关会计信息。
  • Claude AI Ready: 完全符合 Model Context Protocol,确保与 Claude Desktop 的平滑集成。
  • RESTful API (via FastAPI): 提供简单且强大的 FastAPI 服务器以暴露 RESTful 端点。
  • Flexible Configuration: 通过 Claude Desktop 的配置设置轻松配置服务器。

适用场景

  • 会计数据审计
  • AI 工具与 Odoo Accounting 的集成
  • 实验性会计数据分析

工具列表

  • Accounting Data Tools: 用于搜索和检索会计信息的工具。

常见问题解答

  • 如何配置 Odoo 连接?通过 .env 文件或 Claude Desktop 的配置文件设置 Odoo 连接详情。
  • 如何启动服务器?运行 python main.py 命令。

使用教程

使用依赖

  1. 克隆仓库
git clone https://github.com/your-username/odoo-accounting-mcp.git
cd odoo-accounting-mcp
  1. 配置环境变量 创建 .env 文件并填写 Odoo 连接详情:
ODOO_URL=http://localhost:8069
ODOO_DB=your_db_name
ODOO_USERNAME=your_odoo_user_name
ODOO_PASSWORD=your_odoo_password
  1. 设置虚拟环境
python -m venv .venv

激活虚拟环境:

.\.venv\Scripts activate
  1. 安装依赖
python -m pip install -r requirements.txt

安装教程

  1. 运行服务器
python main.py

服务器通常会在 http://localhost:8000 启动。

调试方式

  1. 检查 .env 文件中的 Odoo 连接详情是否正确。
  2. 确保虚拟环境已激活且依赖已安装。
  3. 运行服务器并检查日志输出。

许可证

该项目遵循 MIT 开源许可条款。