内容
# 🧾 Odoo 会计 MCP 服务器
这是一个简化的、不可用于生产的模型上下文协议（MCP）服务器，设计用于通过 XML-RPC 与 **Odoo 会计** 进行实验性集成。特别是为与 [Claude Desktop](https://claude.ai) 配合使用而量身定制，该项目专注于使 AI 工具能够查询和分析 **会计分录** 以用于审计目的。虽然它允许与 Odoo 会计数据交互，但其当前范围仅限于此特定用例，不适用于生产环境。未来的探索可能会考虑扩展到其他与会计相关的數據，例如发票，这取决于初始关注点的结果。
---
### 🔧 示例：Claude 检测 MCP 工具
## 🚀 主要功能
- **安全的 Odoo 连接：** 使用环境变量或专用配置文件与您的 Odoo 实例建立安全连接。
- **会计数据工具：** 提供专门的工具来高效地搜索和检索相关的会计信息。
- **Claude AI 就绪：** 完全符合模型上下文协议，确保与 Claude Desktop 的顺畅集成。
- **RESTful API（通过 FastAPI）：** 提供一个简单且强大的 FastAPI 服务器，用于公开 RESTful 端点。
- **灵活的配置：** 通过 Claude Desktop 的配置设置轻松配置服务器。
---
## 🛠️ 设置指南
按照以下步骤设置和运行 Odoo 会计 MCP 服务器：
### 1. 克隆仓库
```bash
git clone https://github.com/your-username/odoo-accounting-mcp.git
cd odoo-accounting-mcp
```
### 2. 配置环境变量
在项目的根目录中创建一个 `.env` 文件，并用您的 Odoo 连接详细信息填充它：
```ini
ODOO_URL=http://localhost:8069
ODOO_DB=your_db_name
ODOO_USERNAME=your_odoo_user_name
ODOO_PASSWORD=your_odoo_password
```
### 3. 设置虚拟环境
建议使用虚拟环境来管理项目依赖项：
```bash
python -m venv .venv
```
激活它：
```bash
.\.venv\Scripts\activate
```
### 4. 安装依赖项
从 `requirements.txt` 文件中安装所需的 Python 包：
```bash
python -m pip install -r requirements.txt
```
### 5. 运行服务器
使用主要的 Python 脚本启动 MCP 服务器：
```bash
python main.py
```
服务器通常启动并在 `http://localhost:8000` 处可访问。
---
## ⚙️ Claude Desktop 集成
在使用 Claude Desktop 时，您不需要手动运行 MCP 服务器。相反，请配置 Claude Desktop 来管理服务器生命周期。
使用以下配置更新您的 `claude_desktop_config.json` 文件（根据需要调整路径和 Odoo 凭证）：
```json
{
"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 许可证下获得许可。
MCP 市场