InvenTree MCP服务器
MCP服务器 发明树 库存管理。提供12个参数化工具，涵盖零件、库存、构建订单、采购/销售/退货订单、公司、条形码、标签、报告、附件和系统管理的117个操作。
需求
- Python 3.11+
- 紫外线 （推荐）或pip
- 已启用API访问的InvenTree实例
- API令牌（从InvenTree>设置>API令牌生成）
设置
# Clone the repository
git clone https://github.com/puran-water/inventree-mcp.git
cd inventree-mcp
# Copy the example environment file and fill in your values
cp .env.example .env
# Install dependencies
uv sync编辑 .env 使用您的InvenTree实例URL和API令牌：
INVENTREE_URL=https://your-inventree-instance.example.com
INVENTREE_TOKEN=your-api-token-here用法
STDIO模式（默认）
uv run python server.pySSE模式（HTTP传输）
uv run python server.py sse --port 3074克劳德桌面/MCP客户端配置
添加到MCP客户端配置中（例如。 ~/.claude/mcp.json):
{
"mcpServers": {
"inventree-mcp": {
"command": "uv",
"args": ["run", "--directory", "/path/to/inventree-mcp", "python", "server.py"],
"env": {
"INVENTREE_URL": "https://your-inventree-instance.example.com",
"INVENTREE_TOKEN": "your-api-token-here"
}
}
}
}或者对于SSE运输：
{
"mcpServers": {
"inventree-mcp": {
"url": "http://localhost:3074/sse"
}
}
}工具
每个工具都使用参数化 operation 字段以选择特定操作。
| 工具 | 操作 | 说明 |
|---|---|---|
part | 21 | 零件和类别管理（列表、获取、创建、更新、删除、BOM、供应商、参数） |
stock | 16 | 库存物品和位置管理（列表、获取、创建、转移、计数、添加、删除） |
build_order | 9 | 制造构建订单（列表、获取、创建、更新、分配、完成、取消） |
purchase_order | 12 | 采购订单生命周期（列表、获取、创建、更新、发布、接收、完成） |
sales_order | 14 | 销售订单生命周期（列表、获取、创建、发货、分配） |
return_order | 8 | 退货订单管理 |
company | 12 | 供应商、制造商、客户、联系人、地址 |
barcode | 4 | 条形码扫描、分配、取消分配、查找 |
label | 5 | 标签模板列表和打印 |
report | 3 | 报告模板列表和生成 |
attachment | 5 | 任何对象上的文件附件（上传、下载、删除） |
system | 8 | 运行状况、版本、设置、用户、组、货币 |
建筑
server.py--配备12个参数化工具和双传输（STDIO/SSE）的FastMCP服务器client.py--异步适配器封装官方 发明python 图书馆viaasyncio.to_thread()具有用于并发控制的信号量
这 inventree-python 库是同步的（基于请求）。所有调用都被卸载到线程，以保持与MCP框架的异步兼容性。
许可证
麻省理工学院