genai-solutions-mcp

厳選された生成AIツールのデータベース—2023年からNotionで管理している1,197件のレコード—を、AIアシスタントが直接クエリできる4つのツールとして公開するMCPサーバーです。

モデルに「どんな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 にエクスポートし、それをここでバージョン管理し、サーバーはそのファイルのみを読み取ります。トレードオフは鮮度——データは最後の同期時点のものです——と、誰でも15秒でクローンして実行でき、認証情報も呼び出し時のネットワーク依存もレート制限もないサーバーとの間です。元のデータは最大でも週に一度しか変わらないので、鮮度は諦めやすい方です。

部分文字列検索であって、埋め込みベースではない。 約1,100件のレコードは、サブミリ秒の線形スキャンで処理できます。ベクトルインデックスを使うと、同期に埋め込みステップ、モデル依存、非決定論的な結果、そしてスナップショットと整合性を保つためのインデックスが追加されます——その代わりに、ほとんどの有用なクエリが名前とカテゴリであるコーパスでの意味検索が得られます。データセットが一桁大きくなったり、サマリーが長くなったりした場合、これが最初に見直すべき点です。

検索は投影を返し、完全なレコードは返さない。 search_solutions は id、name、type、url のみを返します。20件の結果に対して完全なレコードを返すと、エージェントのコンテキストの大部分を、通常は不要なフィールドに費やすことになります。必要な場合は get_solution があります。

同期ではホワイトリスト（許可リスト）方式を採用し、ブラックリスト（禁止リスト）方式は使わない。 Notionデータベースには、公開されるべきではない内部のワークフロー状態や添付ファイルが含まれています。scripts/sync-notion.ts はエクスポートするプロパティを明示的に指定しているため、後でNotionにプライベートなカラムを追加しても、ここに漏洩することはありません。

既知の制限

• Notionの Type は単一選択のため、各ツールはたとえ2つに当てはまっても、1つのカテゴリしか持ちません。

• カテゴリの値は3年間にわたって手作業で入力されたため、ばらつきがあります。同期では大文字小文字の重複を統合しますが、類義語をマージすることはありません。

• フィールド重み付け部分文字列マッチングを超える関連性ランキングはありません。

• 属性タグ付けにはばらつきがあります。Local と Open Source は異なる時期に異なる習慣で適用され、多くのツールが両方に該当するにもかかわらず、1件のレコードにしか重複していません。フィルターは何がタグ付けされているかについては正直ですが、何が真実かについては正直ではありません——これは、このデータセットがほとんどの実際の内部データベースと共有する特性です。

• Nodeの解決はホスト環境に依存します。サーバーは、起動コンテキストによって同じマシン上の異なるNodeインストールで起動することが観察されました。それが重要な場合は、クライアント設定でランタイムパスを固定してください。

同期（メンテナーのみ）

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

ライセンス

MIT