genai-solutions-mcp

一个MCP服务器，暴露了一个精心整理的生成式AI工具数据库—— 自2023年以来我在Notion中维护的1,197条记录——作为四个工具供AI助手直接查询。

与其让模型猜测存在哪些AI工具并得到一个看似合理但过时的答案， 不如让它搜索一个背后有真人维护的数据集。

> Which open-source tools in here run locally and have a CLI?
> Compare Firecrawl and the other scraping options.

安装

npm install
npm run build
npm start

无需API密钥、无需网络、无需数据库。数据集随仓库一起提供。

将其注册到MCP客户端（此处以Claude Desktop为例）：

{
  "mcpServers": {
    "genai-solutions": {
      "command": "node",
      "args": ["/absolute/path/to/genai-solutions-mcp/dist/src/index.js"]
    }
  }
}

Related MCP server: disvr

工具

设计决策

一个提交的快照，而非实时的Notion代理。 显而易见的设计是在每次工具调用时调用Notion API。但这也使得该仓库对除我之外的任何人都毫无用处：你需要我的令牌和我的数据库。相反，scripts/sync-notion.ts 将Notion导出为 data/solutions.json，该文件在此处进行版本管理，服务器仅读取该文件。这种权衡在于数据新鲜度——数据与上次同步时一样新——而服务器任何人都可以在十五秒内克隆并运行，无需凭证、无运行时网络依赖、无速率限制。底层数据最多每周变化一次，因此新鲜度是较容易放弃的一环。

子串搜索，而非嵌入。 约1,100条记录是一个亚毫秒级的线性扫描。向量索引会增加同步时的嵌入步骤、模型依赖性、非确定性结果以及与快照保持一致的索引——而在这个语料库中，有用的查询大多是名称和类别，额外带来的语义回忆收益有限。如果数据集增长一个数量级或摘要变得更长，这是首先需要重新考虑的问题。

搜索返回投影而非完整记录。 search_solutions 仅返回id、名称、类型和URL。对于20条结果的查询返回完整记录会消耗大量代理上下文在通常不需要的字段上；当需要完整记录时，可以使用 get_solution。

同步时使用属性白名单而非黑名单。 Notion数据库包含不应公开的内部工作流状态和附件。scripts/sync-notion.ts 明确列出它导出的属性，因此稍后在Notion中添加私有列不会悄然泄露到这里。

已知限制

• Notion的 Type 是单选字段，因此每个工具只有一个类别，即使适合两个类别也是如此。

• 类别值是在三年内手动输入的，且不一致；同步功能会折叠大小写重复项，但不会合并近义词。

• 没有基于字段加权子串匹配之外的相关性排序。

• 属性标签不一致。Local 和 Open Source 是在不同时期以不同习惯应用的，它们仅在一条记录上重叠，而实际上许多工具都符合这两个条件。筛选结果如实反映标记情况，而非实际情况——此数据集与大多数真实内部数据库共享此特性。

• Node解析取决于宿主环境。根据启动上下文，该服务器在同一台机器上曾在两个不同的Node安装下启动。如果这对你很重要，请在客户端配置中固定运行时路径。

同步（仅维护者）

NOTION_TOKEN=… NOTION_DATABASE_ID=… npm run sync
git diff data/solutions.json   # read it before committing

许可证

MIT