Mcp Omie

io.github.codespar由 GitHub 账号 codespar 发布v0.2.2更新于 Oct 24, 2026

MCP server for Omie — ERP, customers, products, orders, invoices, financials

已验证STDIO仅桌面金融商业与电商

概览

AI 生成的概览

面向 Omie ERP 的 MCP 服务器，让助手列出和创建客户、产品、订单、发票及财务记录。

可以做什么
列出并创建 Omie ERP 中的客户、产品和公司。列出、创建、修改并查询销售订单，并据此生成发票。列出并创建服务订单和采购订单。列出发票、应收账款、应付账款，并结算应付账款。读取银行账户、银行对账单、财务流水、DRE 科目表、分类、部门和项目。创建现金流水分录和库存调整，并读取当前库存余额。
适用场景
当助手需要在聊天客户端中处理 Omie ERP 数据时适用，例如查询客户、查看库存或财务数据，或在不切换到 Omie 界面的情况下起草订单和发票。
运行要求
通过 npx 和 Node.js 在本地运行。需要 Omie 账户，以及在 Omie 开发者门户注册应用后获得的 app key 和 app secret，通过环境变量 OMIE_APP_KEY 和 OMIE_APP_SECRET 提供。需要访问 Omie API 的网络连接。
安装前请注意
app secret 属于凭据，请勿将 OMIE_APP_KEY 和 OMIE_APP_SECRET 放入共享配置。许多工具会写入 ERP，包括创建客户、产品、订单、发票、应付账款、现金分录和库存调整，以及结算付款；这些操作会改动真实业务记录。README 还提到一项独立的面向代理支付的企业版服务，不属于本服务器。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Mcp Omie，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

@codespar/mcp-omie

MCP server for Omie — ERP with customers, products, orders, invoices, and financials

[npm] [License: MIT]

Quick Start

Claude Desktop

Add to ~/.config/claude/claude_desktop_config.json:

json
{  "mcpServers": {    "omie": {      "command": "npx",      "args": ["-y", "@codespar/mcp-omie"],      "env": {        "OMIE_APP_KEY": "your-app-key",        "OMIE_APP_SECRET": "your-app-secret"      }    }  }}

Claude Code

bash
claude mcp add omie -- npx @codespar/mcp-omie

Cursor / VS Code

Add to .cursor/mcp.json or .vscode/mcp.json:

json
{  "servers": {    "omie": {      "command": "npx",      "args": ["-y", "@codespar/mcp-omie"],      "env": {        "OMIE_APP_KEY": "your-app-key",        "OMIE_APP_SECRET": "your-app-secret"      }    }  }}

Tools (30)

ToolPurpose
list_customersList customers from Omie ERP
create_customerCreate a customer in Omie ERP
list_productsList products from Omie ERP
create_productCreate a product in Omie ERP
create_orderCreate a sales order in Omie ERP
list_ordersList sales orders from Omie ERP
list_invoicesList invoices (NF) from Omie ERP
get_financialList accounts receivable from Omie ERP
create_invoiceConsult a specific NF by ID in Omie ERP
get_company_infoList companies registered in Omie ERP
create_service_orderCreate a service order (OS) in Omie ERP
list_service_ordersList service orders (OS) from Omie ERP
create_purchase_orderCreate a purchase order in Omie ERP
list_purchase_ordersList purchase orders from Omie ERP
get_bank_accountsList registered bank accounts in Omie ERP
create_account_payableCreate an accounts payable (AP) entry in Omie ERP
list_accounts_payableList accounts payable (AP) titles in Omie ERP
pay_account_payableSettle / record payment (baixa) for an AP title in Omie ERP
list_dreList DRE (income statement) chart of accounts in Omie ERP
get_bank_statementRetrieve bank account statement (extrato) for a period from Omie ERP
list_categoriesList chart of accounts categories in Omie ERP
list_departmentsList departments (cost centers) in Omie ERP
list_projectsList projects in Omie ERP
create_cash_entryCreate a bank account ledger entry (lançamento de conta corrente) in Omie ERP
list_financial_movementsList unified financial movements (AP + AR + CC) in Omie ERP
create_stock_adjustmentCreate an inventory adjustment (entry/exit/balance) in Omie ERP
get_stock_positionGet current stock position / balance in Omie ERP
update_sales_orderAlter an existing sales order in Omie ERP
get_sales_orderConsult a specific sales order by ID or integration code in Omie ERP
invoice_sales_orderGenerate an invoice (NF) from an existing sales order in Omie ERP

Authentication

Omie uses JSON-RPC style requests with app_key and app_secret in the request body.

Sandbox / Testing

Omie provides a sandbox via app registration. Create an app to get test credentials.

Get your credentials

  1. Go to Omie Developer Portal
  2. Create an account
  3. Register an application to get app key and secret
  4. Set the environment variables

Environment Variables

VariableRequiredDescription
OMIE_APP_KEYYesOmie app key
OMIE_APP_SECRETYesOmie app secret

Roadmap

v0.3 (planned)

  • create_production_order — Create a production order
  • emit_nfe — Emit NF-e (native emission, not import)
  • reconcile_bank_transaction — Bank reconciliation matching
  • create_service_contract — Service contracts CRUD
  • create_custom_field — Merchant custom fields

Want to contribute? Open a PR or request a tool.

Links

Enterprise

Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.

License

MIT

来源：packages/erp/omie/README.md，提交 d0a519a

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.2.2最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分