Mcp Tiny

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

MCP server for Tiny ERP — products, stock, warehouses, price lists, orders, invoices, AP/AR

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

概览

AI 生成的概览

让助手读取和修改 Tiny ERP 的业务数据，如产品、订单、发票、库存和应付账款。

可以做什么
通过 21 个工具把助手连接到 Tiny ERP。它可以列出并获取产品、订单、联系人、发票、仓库、价格表、分类以及应付和应收账款。它还能修改数据：根据订单创建税务发票（NF-e）、调整产品库存余额、更改销售订单状态，以及通过电子邮件发送已开具的发票。还可以获取发票的 XML 内容和 DANFE PDF 链接。
适用场景
适合助手在日常业务工作中查询或更新 Tiny ERP 记录的场景，例如查看库存或订单状态、核对发票和应付账款，或开具并发送发票。适合已经使用 Tiny ERP、希望通过对话方式访问该系统的团队。
运行要求
作为本地 stdio 进程运行，通常通过 npx 从 npm 包 @codespar/mcp-tiny 启动，因此需要 Node.js 和网络访问。需要 Tiny ERP 账户和 API 令牌，通过环境变量 TINY_API_TOKEN 提供。需要配置桌面客户端。
安装前请注意
TINY_API_TOKEN 密钥可访问 Tiny ERP 账户，必须避免写入共享配置文件。多个工具会写入或发送数据：create_invoice 开具税务发票，update_stock 更改库存余额，update_order_status 更改订单状态，send_invoice_email 向收件人发送邮件。在允许助手执行这些操作前请先确认。

安装

在 SourceWeft 中

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

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

其他 MCP 客户端

参照 仓库 中的启动说明。

README

@codespar/mcp-tiny

MCP server for Tiny ERP — products, orders, contacts, invoices, stock, and accounts payable

[npm] [License: MIT]

Quick Start

Claude Desktop

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

json
{  "mcpServers": {    "tiny": {      "command": "npx",      "args": ["-y", "@codespar/mcp-tiny"],      "env": {        "TINY_API_TOKEN": "your-token"      }    }  }}

Claude Code

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

Cursor / VS Code

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

json
{  "servers": {    "tiny": {      "command": "npx",      "args": ["-y", "@codespar/mcp-tiny"],      "env": {        "TINY_API_TOKEN": "your-token"      }    }  }}

Tools (21)

ToolPurpose
list_productsList products in Tiny ERP
get_productGet product details by ID
list_ordersList sales orders in Tiny ERP
get_orderGet order details by ID
list_contactsList contacts in Tiny ERP
get_contactGet contact details by ID
create_invoiceCreate a fiscal invoice (NF-e) from an order in Tiny
get_invoiceGet invoice details by ID
get_stockGet current stock for a product
list_accounts_payableList accounts payable in Tiny ERP
update_stockUpdate (adjust) product stock balance — credit or debit a quantity for a deposit
list_categoriesList product categories as a tree in Tiny ERP
list_warehousesList stock warehouses (depósitos) configured in Tiny ERP
list_price_listsList price lists (listas de preços) configured in Tiny ERP
update_order_statusChange a sales order's status — useful for cancelling or marking as approved/billed
list_invoicesList fiscal invoices (NF-e/NFC-e) in Tiny ERP
get_invoice_xmlGet the XML payload of an issued invoice (NF-e)
get_invoice_linkGet the DANFE PDF/link for an issued invoice
send_invoice_emailEmail an issued invoice to a recipient
list_accounts_receivableList accounts receivable in Tiny ERP
get_account_receivableGet a single accounts-receivable record by ID

Authentication

Tiny uses a token parameter passed in each request.

Sandbox / Testing

Tiny provides test access via account registration.

Get your credentials

  1. Go to Tiny ERP
  2. Create an account
  3. Navigate to API settings to generate a token
  4. Set the TINY_API_TOKEN environment variable

Environment Variables

VariableRequiredDescription
TINY_API_TOKENYesAPI token from Tiny ERP

Roadmap

v0.2 (planned)

  • create_product — Create a new product
  • update_product — Update product details
  • create_contact — Create a contact (customer/supplier)
  • update_contact — Update contact details
  • get_financial_summary — Get financial summary report

v0.3 (planned)

  • fiscal_reports — Generate fiscal reports (NF-e, NFS-e)
  • multi_company — Multi-company management

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/tiny/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 分