Supplier Directory

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

A supplier directory that does not rot: contacts, payment terms, lead times, due-review report.

已验证STDIO仅桌面效率与工作流商业与电商

概览

AI 生成的概览

本地供应商名录 MCP 服务器，让助手新增、查询、修改和复核供应商记录，并导出为 CSV 或 Markdown。

可以做什么
  • 新增供应商，记录类别、联系方式、付款条件、交货天数和备注，并分配 SUP 编号
  • 按字母顺序列出名录并显示复核时间，可按类别或关键词筛选，也可读取单条完整记录
  • 修改记录中的任意字段、删除供应商，以及把记录标记为已复核
  • 生成逾期复核报告，列出超过 N 天未复核的记录，最久未复核的排在最前（Pro）
  • 将名录导出为 CSV（免费）或 Markdown 表格（Pro）
  • 查询或激活 Pro 授权
适用场景
适合用表格维护供应商联系人、付款条件和交货周期，并希望助手直接回答“哪些记录已经过期”这类问题的自由职业者或小型采购流程。也适合希望数据只留在本机、不需要账号的用户。
运行要求
作为本地进程在用户机器上运行，仅支持桌面端。README 的安装示例使用 npx，但 npm 包尚未发布，目前需要克隆仓库并自行构建。数据保存在本机用户数据目录。可通过 MCP_LICENSE_KEY 环境变量提供可选的 Pro 授权密钥。
安装前请注意
免费版最多保存 10 家供应商；无限条数、Markdown 导出和逾期复核报告需要一次性付费的 Pro 授权，密钥通过 MCP_LICENSE_KEY 提供。工具可以修改和删除供应商记录，删除不可恢复且编号不会重新分配。README 称所有数据都保存在本机，服务器不发起任何网络请求。

安装

在 SourceWeft 中

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

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

其他 MCP 客户端

参照 仓库 中的启动说明。

README

mcp-supplier-list

[theluckystrike/mcp-supplier-list MCP server]

In the official MCP Registry (io.github.theluckystrike/supplier-list). This is the mcp supplier list server: a supplier directory inside your MCP client that does not rot the way the spreadsheet does. Add each supplier once, what they supply, who to contact and how, the payment terms, the lead time in days, and notes, and every record carries the date it was last reviewed, so "which of these records have gone stale?" is a question the directory answers instead of a chore you forget. Ask for a supplier by name, list the directory by category, and export the whole thing to CSV or Markdown when someone else needs it. Everything stays on this machine; there is no account and no network call.

Built by theluckystrike.

npm publish for @theluckystrike/mcp-supplier-list is pending, so npx -y @theluckystrike/mcp-supplier-list returns 404 today. Until then, a clone+build is the working path.

Why not a spreadsheet

A spreadsheet of suppliers rots because nothing in it tells you it is stale: the phone number changed eight months ago and you find out when the order bounces. An mcp supplier list lives where the purchasing conversations already happen, and the review stamp on every record turns "is this still true?" into a report instead of a memory test.

Install

Claude Desktop

macOS ~/Library/Application Support/Claude/claude_desktop_config.json, Windows %APPDATA%\Claude\claude_desktop_config.json:

json
{  "mcpServers": {    "supplier-list": {      "command": "npx",      "args": ["-y", "@theluckystrike/mcp-supplier-list"]    }  }}

Claude Code

sh
claude mcp add supplier-list -- npx -y @theluckystrike/mcp-supplier-list

Cursor

~/.cursor/mcp.json (global) or .cursor/mcp.json (project), same entry as Claude Desktop.

Tools

toolwhat it does
supplier_addAdd a supplier: name, category, contact fields, payment terms, lead time in days, notes. Returns SUP-YYYY-NNNN
supplier_listList the directory A to Z with contact, terms, lead time and review age; filter by category and free text
supplier_getRead one supplier record in full by SUP number or name
supplier_updateChange any fields on a record; only what you pass changes
supplier_removeRemove a supplier, returning the record as it stood. The number is never reissued
supplier_mark_reviewedStamp a record as reviewed on a date, today by default
supplier_due_reviewThe due-review report: records not reviewed in N days (default 90), most overdue first. Pro
supplier_exportExport the directory as CSV (free) or a Markdown table (Pro), with optional category and text filters
license_status / license_activateFree or Pro, and the key

Free vs Pro

FreePro
Suppliers in the directory10Unlimited
Add, list, get, update, removeYesYes
Review stampsYesYes
CSV exportYesYes
Markdown exportNoYes
Due-review reportNoYes

The directory itself is never metered. Ten suppliers is a real working list for a freelancer, and reading, changing, searching and CSV-exporting the suppliers you have stays free for good. What Pro lifts is how many suppliers the directory holds, Markdown export, and the due-review report that keeps a bigger directory honest.

Get Pro: https://mcp.zovo.one/buy/supplier-list, $19 one-time for this server, or $39 for the bundle.

Privacy

All data stays local, in ${XDG_DATA_HOME:-~/.local/share}/mcp-servers/supplier-list/. Two files: suppliers.json, counter.json. Nothing is sent anywhere, there is no account, no API key and no network call in this server at all. License keys are verified offline.

Built by theluckystrike. https://github.com/theluckystrike

Use these docs as an MCP server

Any MCP client (Claude, Cursor, Windsurf, VS Code) can read this repository's documentation directly via GitMCP - no install:

来源：servers/supplier-list/README.md，提交 55b3f42

工具

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

版本历史

2
  1. v0.22.5最新Oct 14, 2026
  2. v0.22.0Sep 23, 2026

评分

已满足适用检查项的 50%

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

  • 近 30 天内可连通25 分

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

  • 已声明认证方式10 分

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

  • 已列出工具15 分

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

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