genai-solutions-mcp

생성형 AI 도구의 선별된 데이터베이스를 제공하는 MCP 서버입니다 — 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으로 내보내며, 이 파일은 여기에서 버전 관리되고 서버는 그 파일만 읽습니다. 트레이드오프는 신선도 — 데이터는 마지막 동기화 시점만큼 최신입니다 — 와 자격 증명, 호출 시 네트워크 의존성, 속도 제한 없이 누구나 15초 안에 클론하고 실행할 수 있는 서버 사이입니다. 기본 데이터는 기껏해야 주 단위로 변경되므로 신선도를 포기하는 것이 더 저렴한 선택입니다.

임베딩이 아닌 부분 문자열 검색. 약 1,100개의 레코드는 서브 밀리초 선형 스캔입니다. 벡터 인덱스는 동기화에 임베딩 단계, 모델 의존성, 비결정적 결과, 스냅샷과 일관성을 유지해야 하는 인덱스를 추가할 것입니다 — 유용한 쿼리가 대부분 이름과 카테고리인 코퍼스에서 의미론적 검색을 얻는 대가로 말입니다. 데이터셋이 한 자릿수 이상 커지거나 요약이 길어지면, 이것이 가장 먼저 재검토할 사항입니다.

검색은 전체 레코드가 아닌 프로젝션을 반환합니다. search_solutions는 id, name, type, url만 반환합니다. 20개 결과 쿼리에 대해 전체 레코드를 반환하면 에이전트의 컨텍스트 중 많은 부분을 일반적으로 필요하지 않은 필드에 소비하게 됩니다. get_solution은 필요할 때 사용할 수 있습니다.

동기화의 속성 화이트리스트, 블랙리스트가 아닙니다. Notion 데이터베이스에는 공개되어서는 안 되는 내부 워크플로 상태와 첨부 파일이 포함되어 있습니다. scripts/sync-notion.ts는 내보내는 속성을 명명하므로 나중에 Notion에서 비공개 열을 추가해도 여기서 조용히 유출될 수 없습니다.

알려진 제한 사항

• Notion의 Type은 단일 선택이므로 각 도구는 두 개가 적합하더라도 정확히 하나의 카테고리를 갖습니다.

• 카테고리 값은 3년에 걸쳐 수동으로 입력되었으며 불균일합니다. 동기화는 대소문자 중복을 접지만 유사어를 병합하지는 않습니다.

• 필드 가중치 부분 문자열 매칭 이상의 관련성 순위는 없습니다.

• 속성 태깅이 불균일합니다. Local과 Open Source는 서로 다른 시기에 서로 다른 습관으로 적용되었으며, 많은 도구가 둘 다에 해당함에도 불구하고 하나의 레코드에서만 겹칩니다. 필터는 무엇이 사실인지가 아니라 무엇이 태그되었는지에 대해 정직합니다 — 이 속성은 대부분의 실제 내부 데이터베이스와 공유하는 특성입니다.

• Node 해석은 호스트 환경에 따라 다릅니다. 서버는 실행 컨텍스트에 따라 같은 머신에서 두 개의 다른 Node 설치로 시작되는 것이 관찰되었습니다. 이것이 중요하다면 클라이언트 구성에서 런타임 경로를 고정하세요.

동기화(관리자 전용)

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

라이선스

MIT