mcpField
M
mcp-tiny

mcp-tiny

本地服务
github.com/codespar商业与营销2754 周前更新
代码仓库

关于 mcp-tiny

@codespar/mcp-tiny 是 Tiny ERP 的 MCP 服务，覆盖商品、订单、往来单位、发票、库存以及应付和应收账款。适合需要在 AI 客户端中处理巴西 ERP 数据的用户。

主要功能

  1. 01商品与订单的查询
  2. 02库存查询与库存调整
  3. 03仓库与价格表列表
  4. 04NF-e 发票的创建、查询与发送
  5. 05应付与应收账款查询
  6. 06通过 TINY_API_TOKEN 进行配置

适用场景

  1. 01让 AI 助手查询库存并调整余额
  2. 02根据订单生成 NF-e 发票并以邮件发送
  3. 03查看应收与应付账款状态

MCP 相关

该项目是 MCP 服务，向 MCP 客户端暴露 21 个工具，用于访问 Tiny ERP 的业务数据。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "codespar-mcp-tiny": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-tiny"
      ],
      "env": {
        "TINY_API_TOKEN": "<TINY_API_TOKEN>"
      }
    }
  }
}
启动命令npx -y @codespar/mcp-tiny
需要配置的环境变量
TINY_API_TOKEN密钥API key for tiny

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@codespar/mcp-tiny0.2.2

工具

21

收录的工具列表 · 更新于 2 周前

参数类型必填说明
paginanumber否页码（默认值为 1）
pesquisastring否搜索词（名称、代码或条形码）

详细介绍

@codespar/mcp-tiny

适用于 Tiny ERP 的 MCP 服务 — 产品、订单、联系人、发票、库存和应付账款

npm License: MIT

快速开始

Claude Desktop

添加到 ~/.config/claude/claude_desktop_config.json：

{
  "mcpServers": {
    "tiny": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-tiny"],
      "env": {
        "TINY_API_TOKEN": "your-token"
      }
    }
  }
}
Claude Code
claude mcp add tiny -- npx @codespar/mcp-tiny
Cursor / VS Code

添加到 .cursor/mcp.json 或 .vscode/mcp.json：

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

工具（21）

工具用途
list_products列出 Tiny ERP 中的产品
get_product按 ID 获取产品详情
list_orders列出 Tiny ERP 中的销售订单
get_order按 ID 获取订单详情
list_contacts列出 Tiny ERP 中的联系人
get_contact按 ID 获取联系人详情
create_invoice根据 Tiny 中的订单创建税务发票（NF-e）
get_invoice按 ID 获取发票详情
get_stock获取产品当前库存
list_accounts_payable列出 Tiny ERP 中的应付账款
update_stock更新（调整）产品库存余额 — 为某个仓库增加或减少指定数量
list_categories以树形结构列出 Tiny ERP 中的产品类别
list_warehouses列出 Tiny ERP 中配置的库存仓库（depósitos）
list_price_lists列出 Tiny ERP 中配置的价格表（listas de preços）
update_order_status更改销售订单状态 — 可用于取消订单，或将其标记为已批准/已开票
list_invoices列出 Tiny ERP 中的税务发票（NF-e/NFC-e）
get_invoice_xml获取已开具发票（NF-e）的 XML 载荷
get_invoice_link获取已开具发票的 DANFE PDF/链接
send_invoice_email将已开具的发票通过电子邮件发送给收件人
list_accounts_receivable列出 Tiny ERP 中的应收账款
get_account_receivable按 ID 获取单条应收账款记录

身份验证

Tiny 使用在每个请求中传递的令牌参数。

沙盒 / 测试

Tiny 可通过注册账号提供测试访问权限。

获取凭据
  1. 前往 Tiny ERP
  2. 创建账号
  3. 前往 API 设置以生成令牌
  4. 设置 TINY_API_TOKEN 环境变量

环境变量

变量必需描述
TINY_API_TOKEN是来自 Tiny ERP 的 API 令牌

路线图

v0.2（计划中）
  • create_product — 创建新产品
  • update_product — 更新产品详情
  • create_contact — 创建联系人（客户/供应商）
  • update_contact — 更新联系人详情
  • get_financial_summary — 获取财务摘要报告
v0.3（计划中）
  • fiscal_reports — 生成税务报告（NF-e、NFS-e）
  • multi_company — 多公司管理

想要贡献？提交 PR，或请求添加工具。

链接

企业版

需要为 Agent 付款提供治理、预算限额和审计跟踪？CodeSpar Enterprise 在这些 MCP 服务之上提供策略引擎、付款路由和合规模板。

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。