{"id":28496290,"url":"https://github.com/musoukun/ragdb-mcp","last_synced_at":"2026-04-20T03:02:22.119Z","repository":{"id":296715958,"uuid":"994269526","full_name":"musoukun/ragdb-mcp","owner":"musoukun","description":"MCP対応のRAGシステム。Markdownドキュメントをベクトル化し、自然言語で高速検索。LibSQL、Qdrant、PostgreSQLに対応してます。","archived":false,"fork":false,"pushed_at":"2025-06-01T15:46:20.000Z","size":124,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-02T20:41:31.307Z","etag":null,"topics":["libsql","mcp","mcp-server","postgresql","qdrant","rag","typescript"],"latest_commit_sha":null,"homepage":"https://musoukun-site.web.app/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/musoukun.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-01T15:31:40.000Z","updated_at":"2025-06-25T07:39:47.000Z","dependencies_parsed_at":"2025-06-03T06:19:21.192Z","dependency_job_id":null,"html_url":"https://github.com/musoukun/ragdb-mcp","commit_stats":null,"previous_names":["musoukun/ragdb-mcp"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/musoukun/ragdb-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/musoukun%2Fragdb-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/musoukun%2Fragdb-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/musoukun%2Fragdb-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/musoukun%2Fragdb-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/musoukun","download_url":"https://codeload.github.com/musoukun/ragdb-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/musoukun%2Fragdb-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32031070,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-20T00:18:06.643Z","status":"online","status_checked_at":"2026-04-20T02:00:06.527Z","response_time":94,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["libsql","mcp","mcp-server","postgresql","qdrant","rag","typescript"],"created_at":"2025-06-08T12:07:09.051Z","updated_at":"2026-04-20T03:02:22.101Z","avatar_url":"https://github.com/musoukun.png","language":"TypeScript","funding_links":[],"categories":["🌐 Web Development"],"sub_categories":[],"readme":"# RAG MCP Server（RAGDB)\n\n**MCP対応チャットで、RAGDBを管理/検索できるMCPです。**\n\n### 🤖 MCP対応チャットでとMCPについて\n\n-   このシステムをインストールすると、MCP対応チャットで文書をRAGDBに保存・ベクトル検索ができるようになります。\n-   コマンドを入力するだけで、MCP対応チャットで文書を管理できます。\n-   Markdown形式のドキュメントをベクトル化して保存します。\n## ✨ できること\n\n### 📚 文書の保存と検索\n\n-   **文書を保存**: Markdownファイルをemmbeddingでベクトル化してRAGDBに保存\n-   **質問で検索**: 「この技術の使い方は？」のような質問で検索\n-   **Markdownファイル一括登録**: スクリプトMarkdownファイルをRAGDBに一括登録できます。\n\n### 💾 3つのデータベース選択肢\n\n-   **LibSQL** :ローカルファイルで動作し、DBサーバーを必要としません。\n-   **Qdrant** :クラウド対応で、大量データ対応です。\n-   **PostgreSQL**: 大量データ対応（テスト中ですが動作確認済）\n\n## 🚀 始め方\n\n### 前提条件\n\n-   libsqlを利用する場合は、libsqlのデータベースファイルが自動作成されます。\n-   PgvectorやQdrantを利用する場合はDBサーバーが必要です。（Docker環境をお勧めします。）\n-   埋め込みプロバイダーのAPIキー（OpenAI または Google）\n\n### VS CodeおよびClaude Desktopでの使用\n\n手動インストールの場合、VS CodeのUser Settings (JSON)ファイルに以下のJSONブロックを追加してください。`Ctrl + Shift + P`を押して`Preferences: Open User Settings (JSON)`と入力することで設定ファイルを開けます。\n\nそのほかのDBの例は、jsonフォルダのサンプルをご覧ください。\nINDEXについてはデフォルトでdocumentsを設定していて、必要に応じて追加してください。\n\n```json\n{\n    \"mcpServers\": {\n        \"rag-server\": {\n            \"command\": \"node\",\n            \"args\": [\"your-ragdb-mcp-path/rag-mcp/dist/index.js\"],\n            \"env\": {\n                \"RAG_DATABASE_TYPE\": \"libsql\",\n                \"RAG_CONNECTION_URL\": \"file:your-ragdb-mcp-path/rag-mcp/libsql/rag.db\",\n                \"EMBEDDING_PROVIDER\": \"google\",\n                \"EMBEDDING_MODEL\": \"text-embedding-004\",\n                \"EMBEDDING_API_KEY\": \"your-google-api-key\",\n                \"EMBEDDING_DIMENSIONS\": \"768\",\n                \"RAG_CHUNK_SIZE\": \"512\",\n                \"RAG_CHUNK_OVERLAP\": \"50\",\n                \"RAG_TOP_K\": \"5\",\n                \"RAG_STRATEGY\": \"markdown\",\n                \"AUTO_CREATE_INDEXES\": \"documents,technical\", \n                \"LOG_LEVEL\": \"info\"\n            }\n        }\n    }\n}\n```\n\n### 環境変数の設定\n\n| 環境変数             | 説明                                 | 例                                                        |\n| -------------------- | ------------------------------------ | --------------------------------------------------------- |\n| `RAG_DATABASE_TYPE`  | データベースタイプ                   | `libsql`, `pgvector`, `qdrant`                            |\n| `RAG_CONNECTION_URL` | データベース接続URL                  | `./database.db` (LibSQL), `postgresql://...` (PostgreSQL) |\n| `RAG_QDRANT_URL`     | Qdrant接続URL（Qdrant使用時）        | `http://localhost:6333`                                   |\n| `EMBEDDING_PROVIDER` | 埋め込みプロバイダー                 | `openai`, `google`                                        |\n| `EMBEDDING_MODEL`    | 埋め込みモデル                       | `text-embedding-3-small`, `text-embedding-gecko@003`      |\n| `EMBEDDING_API_KEY`  | APIキー                              | OpenAIまたはGoogleのAPIキー                               |\n| `RAG_CHUNK_SIZE`     | チャンクサイズ（オプション）         | `512`                                                     |\n| `RAG_CHUNK_OVERLAP`  | チャンクオーバーラップ（オプション） | `50`                                                      |\n| `RAG_TOP_K`          | 検索結果数（オプション）             | `5`                                                       |\n\n### 利用可能なツール\n\n| ツール名                     | 説明                       | パラメータ                                                                                 |\n| ---------------------------- | -------------------------- | ------------------------------------------------------------------------------------------ |\n| `create_index`               | インデックスを作成         | `indexName`: インデックス名, `dimension?`: ベクター次元数                                  |\n| `delete_index`               | インデックスを削除         | `indexName`: インデックス名                                                                |\n| `list_indexes`               | インデックス一覧を表示     | なし                                                                                       |\n| `add_document`               | Markdownドキュメントを追加 | `content`: 文書内容, `metadata?`: メタデータ, `chunkingOptions?`: チャンキング設定         |\n| `update_document`            | ドキュメントを更新         | `documentId`: ドキュメントID, `content?`: 新しい内容, `metadata?`: メタデータ              |\n| `delete_document`            | ドキュメントを削除         | `documentId`: ドキュメントID, `indexName?`: インデックス名                                 |\n| `search_documents`           | 基本的なドキュメント検索   | `query`: 検索クエリ, `indexName?`: インデックス名, `options?`: 検索オプション              |\n| `rag_search`                 | 質問応答形式のRAG検索      | `question`: 質問, `indexName?`: インデックス名, `options?`: 検索オプション                 |\n| `advanced_rag_search`        | フィルター機能付き高度検索 | `query`: 検索クエリ, `filters?`: メタデータフィルター, `searchOptions?`: 検索設定          |\n| `semantic_similarity_search` | セマンティック類似検索     | `referenceText`: 参照テキスト, `indexName?`: インデックス名, `options?`: 検索オプション    |\n| `list_documents`             | ドキュメント一覧を表示     | `indexName?`: インデックス名, `limit?`: 取得数, `offset?`: 開始位置, `filter?`: フィルター |\n| `get_rag_info`               | RAGシステム情報を表示      | なし                                                                                       |\n\n### 基本的な使用例\n\n1. **インデックス作成**：\n\n    ```\n    create_index indexName=\"my-docs\"\n    ```\n\n2. **ドキュメント追加**：\n\n    ```\n    add_document content=\"# プロジェクト概要\\n\\nこのプロジェクトは...\" metadata={\"title\": \"プロジェクト概要\", \"category\": \"技術文書\"}\n    ```\n\n3. **質問で検索**：\n\n    ```\n    rag_search question=\"このプロジェクトの目的は何ですか？\"\n    ```\n\n4. **ドキュメント一覧表示**：\n    ```\n    list_documents limit=10\n    ```\n\n## 📄 ライセンス\n\n自由に使用・改変・商用利用可能です。\nMCPを通常使用する場合、商用利用は可能ですが\n\nただしRAGDBとのやり取りや処理は、mastraのライブラリを利用して実装しています。\n\nmastraはElastic License 2.0のため、例えばMastraのPlayground部分をそのままSaasサービスとして\n提供したりすることできないので注意してください。\n\n詳しくは以下もご覧ください。\nhttps://mastra.ai/ja/docs/faq#elastic-license-20-elv2\n\n## 🤝 改善提案・バグ報告\n\n不具合を見つけた方、改善アイデアをお持ちの方は、GitHubのIssuesまでお知らせください。\n\n---\n\n**🎉 MCP対応チャットでがあなた専用の文書検索アシスタントになります！**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmusoukun%2Fragdb-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmusoukun%2Fragdb-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmusoukun%2Fragdb-mcp/lists"}