yuki MCP

MCPAI代理

提供方 CodeMill-Solutions

AI代理 未标注 API Key 社区 / 第三方 Claude

一个连接AI代理与Yuki会计系统的MCP服务器,通过SOAP API实现会计数据交互。

一句话选型结论

按资料字段整理

yuki MCP 属于AI代理类 MCP 服务器,传输方式未标注,API Key,可直接接入 Claude,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式未标注 鉴权API Key 部署方式未标注
GitHub 星标 4 仓库热度,无公开仓库时显示未标注
工具数 30 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量30暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

会计自动化TypeScript本地部署SOAPAPIAI代理集成财务数据管理多账户支持

安装与配置

未标注 API Key
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 30 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 30 个工具,覆盖面较广,能满足多种调用。
  • 已适配 Claude,换客户端不用重新研究配置。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好API Key对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 已经在用 Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
yuki MCP当前 30 未标注 未标注 无 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方CodeMill-Solutions上游标注的维护方 CodeMill-Solutions
分类AI代理本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式API Key远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

14.4 KB
来自项目仓库与上游目录的原文,未做删改

小雪

A. 模型上下文协议 将AI代理连接到的(MCP)服务器 由纪 通过Yuki的SOAP API进行会计。

使用Node.js、TypeScript和 @modelcontextprotocol/sdk.


安装```bash

npm install @codemill-solutions/yuki-mcp


然后将其添加到MCP主机配置中(例如。 `claude_desktop_config.json`):```json
{
"mcpServers": {
"yuki": {
"command": "node",
"args": ["node_modules/@codemill-solutions/yuki-mcp/dist/index.js"],
"env": {
"YUKI_API_KEY": "your-api-key-here",
"YUKI_DOMAIN_ID": "your-administration-guid-here"
}
}
}
}

先决条件

  • Node.js 20+
  • 启用API访问的Yuki帐户
  • 您的Yuki API密钥(Yuki→ 设置→ API)

设置

1.安装依赖项```bash

npm install


### 2.配置环境变量```bash
cp .env.example .env

编辑 .env:```env
YUKI_API_KEY=your-api-key-here
YUKI_DOMAIN_ID=your-administration-guid-here # optional at startup


`YUKI_DOMAIN_ID` 可以留空——服务器在没有它的情况下启动。调用 `get_administrations` 要发现正确的GUID,请通过 `administrationId` 单个工具上的参数。

### 3.建造```bash
npm run build

4.连接到MCP主机

添加到MCP主机配置中(例如。 claude_desktop_config.json):```json
{
"mcpServers": {
"yuki": {
"command": "node",
"args": ["/absolute/path/to/yuki-mcp/dist/index.js"],
"env": {
"YUKI_API_KEY": "your-api-key-here",
"YUKI_DOMAIN_ID": "your-administration-guid-here"
}
}
}
}


______________________________________________________________________

## 多管理支持

如果你能做到 **多届Yuki政府** (每个都有自己的API密钥),您可以提供一个JSON文件,该文件映射 `administrationId` 到其对应的API密钥。然后,服务器会自动对每次管理进行身份验证,不需要单个共享密钥。

### 密钥文件格式```json
{
"a1b2c3d4-0000-0000-0000-000000000001": "api-key-for-admin-1",
"a1b2c3d4-0000-0000-0000-000000000002": "api-key-for-admin-2"
}

路径解析(第一场比赛获胜)

优先级 路径
1 YUKI_API_KEYS_FILE 环境变量(显式路径)
2 ~/.yuki/api-keys.json (默认用户级位置)
3 ./api-keys.json (当地发展后备方案)

环境变量```env

YUKI_API_KEYS_FILE=/path/to/your/api-keys.json


当存在密钥文件时, `YUKI_API_KEY` 变为可选--文件密钥用于所有特定于管理的工具调用,以及 `YUKI_API_KEY` (如果设置)作为不针对特定管理的工具的后备方案(例如。 `get_administrations`).

如果两者都没有 `YUKI_API_KEY` 启动时找不到密钥文件,服务器会记录一个警告,但会继续运行——工具在调用时会返回一个错误。

______________________________________________________________________

## 可用工具(30)

### 行政部门

|工具|说明|
|------|-------------|
| `get_administrations` |列出此API密钥的所有管理机构(公司)。 **先运行这个** 找到正确的 `administrationId`. |
| `get_administration_id` |按确切名称查找管理的GUID。当您知道名称但不知道GUID时很有用。 |

### 关系

|工具|关键参数|说明|
|------|----------------|-------------|
| `search_relations` | `searchValue`, `searchOption?`, `active?`, `pageNumber?` |按名称、代码、增值税号、电子邮件等搜索客户和供应商。每页最多返回100个结果。 |
| `upsert_contact` | `fullName`, `contactCode?`, `contactType?`,…|创建或更新联系人。当 `contactCode` 匹配更新的现有记录;否则创建新联系人。 |

### 销货

|工具|关键参数|说明|
|------|----------------|-------------|
| `get_sales_invoices` | `dateOutstanding?`, `sortOrder?`, `includeBankTransactions?` |检索未付的销售发票。 |
| `process_sales_invoice` | `reference`, `subject`, `date`, `dueDate`, `contact`, `lines` |创建并预订新的销售发票。可选择将其通过电子邮件发送给客户。 |

### 购货发票

|工具|关键参数|说明|
|------|----------------|-------------|
| `get_missing_invoices` |--|检索仍需要匹配的购买发票的银行付款--相当于“Postbus”→ Yuki网络界面中的“Ontbrekende manufacturer”|
| `get_purchase_invoices` | `dateOutstanding?`, `sortOrder?`, `includeBankTransactions?` |检索未付的采购发票。 |
| `process_purchase_invoice` | `date`, `invoiceAmount`, `invoiceVatAmount`, `contact`, `lines` |预订进货发票。接受可选的base64格式的PDF。 |

### 交易和银行

|工具|关键参数|说明|
|------|----------------|-------------|
| `get_transactions` | `glAccountCode`, `startDate`, `endDate` |检索日期范围内总账账户(如银行账户)的日记账分录。使用 `get_gl_accounts` 找到正确的代码。 |
| `get_transaction_details` | `reference` |检查未完成的项目是否仍然存在,并检索其当前状态。 |
| `process_journal` | `subject`, `entries[]` |发表一篇普通日记(回忆录)。所有输入金额的总和必须恰好为0。用于银行对账、更正和自定义预订。 |

### 会计

|工具|关键参数|说明|
|------|----------------|-------------|
| `get_gl_accounts` | `date?` |检索给定日期的所有总账账户及其余额(商业视图)。调用前使用此功能查找帐户代码 `get_transactions`. |
| `get_gl_accounts_fiscal` | `date?` |与 `get_gl_accounts` 但包括财政调整。用于必须与Yuki的财务报告相匹配的资产负债表和损益表视图。 |
| `get_net_revenue` | `startDate`, `endDate`, `fiscal?` |检索日期范围内的净收入(netto omzet)。集 `fiscal=true` 包括财政修正。 |

### 会计信息

从中获得更丰富的只读视图 `AccountingInfo.asmx` 服务——标准不提供 `Accounting.asmx`.

|工具|关键参数|说明|
|------|----------------|-------------|
| `get_gl_account_scheme` |--|检索完整的总账科目方案(rekeningschema):所有具有类型、子类型、描述和活动/非活动状态的代码。用于验证总账代码或构建账户选择器。 |
| `get_period_table` | `yearId` |检索一年的会计期间表:期间编号、名称和日期范围。用于将交易日期转换为人类可读的报告期间名称。 |
| `get_gl_transactions_detailed` | `startDate`, `endDate`, `glAccountCode?`, `financialMode?` |详细的交易列表,包括文档类型、存档文件夹、会计期间ID、项目代码和突变用户。比更完整 `get_transactions`.离开 `glAccountCode` 所有帐户均为空。 |
| `get_transaction_document` | `transactionId` |以base64格式下载已预订交易的源PDF。使用 `id` 或 `hID` 从 `get_gl_transactions_detailed`. |
| `get_start_balances` | `yearId`, `financialMode?` |检索一个会计年度每个总账账户的期初余额(beginbalansen)。 |

### 文件

|工具|关键参数|说明|
|------|----------------|-------------|
| `upload_document` | `fileName`, `dataBase64`, `folder?`, `amount?` |通过将PDF的内容以base64字符串的形式传递,将其上传到Yuki存档。使用 `get_document_folders` 首先找到正确的文件夹ID|
| `upload_document_from_path` | `filePath`, `fileName?`, `folder?`, `amount?` |从本地文件路径上传PDF。在内部读取和编码文件——优先于 `upload_document` 当文件在磁盘上可用时。上传前验证文件是否存在并且是有效的PDF。 |
| `get_document_folders` |--|列出管理中可用的所有存档文件夹。 |
| `list_documents` | `folderId` |列出特定存档文件夹中的文档。返回文档ID、文件名、日期和金额。 |
| `search_documents` | `searchText` |对所有存档文档(文件名、金额、OCR内容)进行全文搜索。 |
| `get_document` | `documentId` |按ID(名称、文件夹、日期、金额、状态)检索单个存档文档的元数据。 |
| `download_document` | `documentId` |以base64编码字符串的形式下载存档文档|
| `get_cost_categories` |--|列出可用的总账成本类别,用作 `costCategory` 上传工具中的参数。 |

### 后台办公室

|工具|关键参数|说明|
|------|----------------|-------------|
| `get_workflow` | `administrationId?` |检索后台工作流程项目——无法自动处理并等待会计审查的文档。 |
| `get_outstanding_questions` | `administrationId?` |在处理相关文件之前,检索会计师提出的需要回复的未决问题。 |

______________________________________________________________________

## 测试

### 选项1-MCP检查员(工具级,无LLM)```bash
npm run inspect

在以下位置打开浏览器UI http://localhost:5173 在那里,您可以调用单个工具并检查原始响应。

选项2——代理测试工具(带Claude)

运行一个完整的代理循环:Claude对任务进行推理,调用工具,并返回最终答案——就像AI代理使用此MCP一样。

将您的Anthropic API密钥添加到 .env:```env
ANTHROPIC_API_KEY=sk-ant-...


然后运行一个场景:```bash
npm run agent                                              # default: get_administrations
npm run agent -- --scenario outstanding-invoices
npm run agent -- --scenario search-relations --arg "Bedrijf BV"
npm run agent -- --scenario gl-accounts
npm run agent -- --scenario bank-transactions --arg "1200"
npm run agent -- --scenario full-workflow

可用场景: get-administrations, search-relations, outstanding-invoices, outstanding-payables, gl-accounts, bank-transactions, full-workflow.


建筑```

src/
├── index.ts # Entry point — loads env + keys file, registers tools, starts stdio transport
├── yuki-client.ts # SOAP client: per-key session cache, envelope builder, axios HTTP, fast-xml-parser
└── tools/
├── administrations.ts # get_administrations, get_administration_id
├── relations.ts # search_relations, upsert_contact
├── invoices.ts # get_sales_invoices, get_purchase_invoices,
│ # process_sales_invoice, process_purchase_invoice
├── transactions.ts # get_transactions, get_transaction_details, process_journal
├── accounting.ts # get_gl_accounts, get_gl_accounts_fiscal, get_net_revenue
├── accounting-info.ts # get_gl_account_scheme, get_period_table,
│ # get_gl_transactions_detailed, get_transaction_document,
│ # get_start_balances, get_missing_invoices
├── documents.ts # upload_document, upload_document_from_path,
│ # get_document_folders, list_documents, search_documents,
│ # get_document, download_document, get_cost_categories
└── backoffice.ts # get_workflow, get_outstanding_questions

scripts/
└── test-agent.ts # Agent test harness (Claude + MCP client loop)
```

认证流程

Yuki使用两步身份验证模式:

  1. Authenticate(accessKey) → 返回临时 sessionID
  2. 所有后续通话都包括 sessionID

YukiClient.getSessionID(adminId?) 透明地处理这个问题。当与A通话时 administrationId,它从加载的密钥映射中解析匹配的API密钥。在进程的生命周期内,每个API键缓存会话ID- Authenticate 每个键只调用一次,而不是每个工具调用一次。

> 注: Yuki服务中的参数大小写不同-- sessionId (小写d)on Sales.asmx 和 Purchase.asmx; sessionID (大写D)on Accounting.asmx, AccountingInfo.asmx, Contact.asmx,以及 Archive.asmx。这是按工具处理的。

XML文档

编写工具(process_sales_invoice, process_purchase_invoice, process_journal, upsert_contact)将结构化数据作为XML字符串传递给Yuki xmlDoc SOAP参数。这 XmlValue 包装器确保此XML原始嵌入(不是实体编码)在SOAP信封中。所有用户提供的值都是通过XML转义的 escapeXml().


费率限制

Yuki执行 每天1000个API请求 (可升级至5000至10000)。每次工具调用都是一个请求。会话ID已缓存,因此 Authenticate 每个服务器进程每个API键只调用一次,而不是每个工具调用一次。

设计代理工作流,一次性获取广泛列表并从代理的上下文窗口引用它们,而不是在每一步都重新获取。


故障排除

错误 可能原因
SOAP Fault: Authentication failed YUKI_API_KEY 不正确或在Yuki设置中未启用API访问
No API key found for administration … The administrationId 传递给工具的密钥不在加载的密钥文件中--检查 YUKI_API_KEYS_FILE
SOAP Fault: Administration not found 错了 administrationId --奔跑 get_administrations 获取正确的GUID
Journal entries do not balance 金额 process_journal 总和不等于0——检查借记/贷记标志
HTTP 500 from api.yukiworks.nl 通常是错误的XML命名空间或格式错误 xmlDoc --在以下位置检查WSDL https://api.yukiworks.nl/ws/{Service}.asmx?wsdl
File does not appear to be a PDF 文件位于 filePath 不以开头 %PDF magic bytes--检查您是否指向有效的PDF
File not found filePath 传递给 upload_document_from_path 不存在或无法访问
Network error 没有连接到 api.yukiworks.nl --请求在30秒后超时

关于CodeMill解决方案

CodeMill解决方案 是一家总部位于荷兰的荷兰软件公司。我们构建智能、可扩展和定制的解决方案,帮助组织发展、优化流程并实现其数字化目标。

我们的服务包括:

  • 定制应用 --门户、仪表板、业务软件和真正增值的完全定制的平台。
  • API集成 -通过智能API连接将您的应用程序与其他系统和外部平台连接。
  • 移动应用 --iOS和Android应用程序作为web应用程序的逻辑扩展。

yuki-mcp 是我们的开源集成之一,使Yuki的会计平台可以通过模型上下文协议供人工智能代理访问。

📧 info@codemill.dev
🌐 codemill.dev
💼 领英
🐙 GitHub


许可证

麻省理工学院——见 许可证.

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
yuki MCP 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

yuki MCP 怎么在 Claude 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

yuki MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

yuki MCP 需要 API Key 吗?

资料标注需要API Key认证,使用前准备好对应凭据,并按最小权限配置。

yuki MCP 支持哪些客户端?

资料标注支持 Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

yuki MCP 能提供哪些能力?

资料显示约 30 个工具;能力标签包括 TypeScript、Claude、AI代理。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。