关于 supplier-list
supplier-list 是供 MCP 客户端使用的本地供应商目录,记录联系人、付款条款、交货周期和审核日期。它支持按类别检索及导出,并将数据保存在本机。
主要功能
- 01记录供应商及联系信息
- 02保存付款条款与交货周期
- 03标记审核日期并筛查过期记录
- 04按名称或类别查找供应商
- 05导出 CSV 或 Markdown
适用场景
- 01集中管理采购联系人与供应信息
- 02检查供应商资料是否需要重新审核
- 03按类别整理供应商目录
- 04将供应商目录导出供他人查看
MCP 相关
作为 MCP 服务,向客户端提供供应商的新增、查询、修改、删除、审核和导出工具。数据保存在本机,不进行网络调用。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://mcp.zovo.one/mcp/supplier-listclaude mcp add --transport http theluckystrike-supplier-list https://mcp.zovo.one/mcp/supplier-list{"mcpServers":{"theluckystrike-supplier-list":{"type":"http","url":"https://mcp.zovo.one/mcp/supplier-list"}}}在 Cursor 中打开{"servers":{"theluckystrike-supplier-list":{"type":"http","url":"https://mcp.zovo.one/mcp/supplier-list"}}}在 VS Code 中打开{"mcpServers":{"theluckystrike-supplier-list":{"type":"http","url":"https://mcp.zovo.one/mcp/supplier-list"}}}{"mcpServers":{"theluckystrike-supplier-list":{"serverUrl":"https://mcp.zovo.one/mcp/supplier-list"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
https://mcp.zovo.one/mcp/supplier-list需要授权工具
10| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| name | string | 是 | 您向其采购的对象,例如 Shenzhen Box Co 或 Acme Fasteners |
| string | 否 | 订单或账务联系邮箱 | |
| notes | string | 否 | 值得记住的事项:最低订购量、需要升级处理时的联系人、上次停止合作的原因 |
| phone | string | 否 | 可直接拨打的电话号码 |
| address | string | 否 | 邮寄地址或到访地址 |
| website | string | 否 | 网站或店铺 URL |
| category | string | 是 | 供应内容,例如 Packaging、Raw materials、Print。可自由填写;supplier_list 会按此筛选 |
| contact_name | string | 否 | 您在该供应商处的联系人,例如 Maria Chen |
| payment_terms | string | 否 | 采购付款条件,例如 Net 30、50% upfront、Due on receipt |
| lead_time_days | integer | 否 | 从下单到交付的常规天数,例如 14 |
详细介绍
mcp-supplier-list
已收录于官方 MCP Registry(io.github.theluckystrike/supplier-list)。
这是 mcp-supplier-list 服务:一个位于 MCP 客户端中的供应商名录,不会像电子表格那样逐渐过时。每家供应商只需添加一次,记录其供应的物品、联系人及联系方式、付款条款、交货周期(天)和备注;每条记录都会附带上次审核日期,因此,“哪些记录已经过时?”这个问题可以由名录直接回答,而不是变成一件容易忘记的琐事。按名称查找供应商,按类别浏览名录,或者在其他人需要时将全部内容导出为 CSV 或 Markdown。所有数据都保留在这台机器上;无需账户,也不会发起网络请求。
由 theluckystrike 构建。
@theluckystrike/mcp-supplier-list 尚待发布到 npm,因此今天运行 npx -y @theluckystrike/mcp-supplier-list 会返回 404。在此之前,克隆并构建是可用的方式。
为什么不使用电子表格
供应商电子表格会逐渐过时,因为其中没有任何内容会提醒你信息已经过期:电话号码八个月前就变了,直到订单被退回时你才发现。mcp-supplier-list 位于采购沟通已经发生的地方,而每条记录上的审核标记能将“这条信息现在还准确吗?”变成一份报告,而不是记忆力测试。
安装
Claude Desktop
macOS:~/Library/Application Support/Claude/claude_desktop_config.json;Windows:%APPDATA%\Claude\claude_desktop_config.json:
{
"mcpServers": {
"supplier-list": {
"command": "npx",
"args": ["-y", "@theluckystrike/mcp-supplier-list"]
}
}
}
Claude Code
claude mcp add supplier-list -- npx -y @theluckystrike/mcp-supplier-list
Cursor
~/.cursor/mcp.json(全局)或 .cursor/mcp.json(项目),配置项与 Claude Desktop 相同。
工具
| 工具 | 功能 |
|---|---|
supplier_add | 添加供应商:名称、类别、联系人字段、付款条款、交货周期(天)和备注。返回 SUP-YYYY-NNNN |
supplier_list | 按 A 到 Z 的顺序列出名录,并显示联系人、条款、交货周期和距上次审核的时间;可按类别和自由文本筛选 |
supplier_get | 按 SUP 编号或名称完整读取一条供应商记录 |
supplier_update | 修改记录中的任意字段;只会更改传入的字段 |
supplier_remove | 移除供应商,并返回移除前的记录。编号永不重新发放 |
supplier_mark_reviewed | 将记录标记为已在指定日期审核,默认使用今天的日期 |
supplier_due_review | 到期审核报告:列出 N 天内未审核的记录(默认 90 天),并按逾期时间从长到短排列。Pro |
supplier_export | 将名录导出为 CSV(免费)或 Markdown 表格(Pro),可选类别和文本筛选条件 |
license_status / license_activate | 查看免费版或 Pro 版本状态,并管理密钥 |
免费版与 Pro 版
| 免费版 | Pro 版 | |
|---|---|---|
| 名录中的供应商数量 | 10 | 不限 |
| 添加、列出、读取、更新、移除 | 是 | 是 |
| 审核标记 | 是 | 是 |
| CSV 导出 | 是 | 是 |
| Markdown 导出 | 否 | 是 |
| 到期审核报告 | 否 | 是 |
名录本身永远不会按使用量计费。对于自由职业者而言,10 家供应商就足以构成一份真正可用的名录;读取、修改、搜索和将现有供应商导出为 CSV,始终免费。Pro 版提升的是名录可容纳的供应商数量,并提供 Markdown 导出和到期审核报告,让更大的名录也能保持准确。
获取 Pro 版:https://mcp.zovo.one/buy/supplier-list,此服务一次性付费 $19,或以 $39 购买套装。
隐私
所有数据都保留在本地,存储于 ${XDG_DATA_HOME:-~/.local/share}/mcp-servers/supplier-list/。共有两个文件:suppliers.json、counter.json。不会向任何地方发送数据,无需账户或 API 密钥,且此服务完全不会发起网络请求。许可证密钥会在离线状态下验证。
由 theluckystrike 构建。https://github.com/theluckystrike
使用这些文档作为 MCP 服务
任何 MCP 客户端(Claude、Cursor、Windsurf、VS Code)都可以通过 GitMCP 直接读取此代码库的文档,无需安装:
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。