# 安装 io.github.shinpr/mcp-local-rag

- 类型: MCP 工具
- 说明: 帮助用户快速搭建本地 RAG 服务，实现私有知识检索与问答集成。
- 仓库: https://github.com/shinpr/mcp-local-rag

## 方式一 · 一键代装（复制提示词让 AI 代劳）

### Claude Code
```
请帮我安装 askskill 上的 "io.github.shinpr/mcp-local-rag" MCP 服务：
执行：claude mcp add 'io-github-shinpr-mcp-local-rag' -- npx -y mcp-local-rag
```

### Codex
```
请帮我安装 askskill 上的 "io.github.shinpr/mcp-local-rag" MCP 服务：
在 ~/.codex/config.toml 中添加：
[mcp_servers.io-github-shinpr-mcp-local-rag]
command = "npx"
args = ["-y","mcp-local-rag"]
然后重启 Codex 生效
```

### Cursor
```
请帮我安装 askskill 上的 "io.github.shinpr/mcp-local-rag" MCP 服务：
在 .cursor/mcp.json 的 "mcpServers" 中添加：
"io-github-shinpr-mcp-local-rag": { "command": "npx", "args": ["-y","mcp-local-rag"] }
然后在 Cursor 设置 > MCP 中启用
```

## 方式二 · 命令行安装（原生命令与配置）

### Claude Code
```bash
claude mcp add --env BASE_DIR=YOUR_VALUE --env BASE_DIRS=YOUR_VALUE --env IGNORE_PATHS=YOUR_VALUE --env DB_PATH=YOUR_VALUE --env CACHE_DIR=YOUR_VALUE --env HF_ENDPOINT=YOUR_VALUE --env MODEL_NAME=YOUR_VALUE --env MAX_FILE_SIZE=YOUR_VALUE --env RAG_MAX_DISTANCE=YOUR_VALUE --env RAG_GROUPING=YOUR_VALUE --env RAG_MAX_FILES=YOUR_VALUE --env CHUNK_MIN_LENGTH=YOUR_VALUE --env STORE_IMAGES=YOUR_VALUE --env EMBED_TITLE_PREFIX=YOUR_VALUE --env EMBED_HEADING_PREFIX=YOUR_VALUE --env RAG_DEVICE=YOUR_VALUE --env RAG_DTYPE=YOUR_VALUE --env RAG_HYBRID_WEIGHT=YOUR_VALUE --env RAG_RERANK_CMD=YOUR_VALUE --env RAG_RERANK_TIMEOUT_MS=YOUR_VALUE --transport stdio io-github-shinpr-mcp-local-rag -- npx -y mcp-local-rag
```
需要环境变量：BASE_DIR, BASE_DIRS, IGNORE_PATHS, DB_PATH, CACHE_DIR, HF_ENDPOINT, MODEL_NAME, MAX_FILE_SIZE, RAG_MAX_DISTANCE, RAG_GROUPING, RAG_MAX_FILES, CHUNK_MIN_LENGTH, STORE_IMAGES, EMBED_TITLE_PREFIX, EMBED_HEADING_PREFIX, RAG_DEVICE, RAG_DTYPE, RAG_HYBRID_WEIGHT, RAG_RERANK_CMD, RAG_RERANK_TIMEOUT_MS

### Codex
```bash
codex mcp add --env BASE_DIR=YOUR_VALUE --env BASE_DIRS=YOUR_VALUE --env IGNORE_PATHS=YOUR_VALUE --env DB_PATH=YOUR_VALUE --env CACHE_DIR=YOUR_VALUE --env HF_ENDPOINT=YOUR_VALUE --env MODEL_NAME=YOUR_VALUE --env MAX_FILE_SIZE=YOUR_VALUE --env RAG_MAX_DISTANCE=YOUR_VALUE --env RAG_GROUPING=YOUR_VALUE --env RAG_MAX_FILES=YOUR_VALUE --env CHUNK_MIN_LENGTH=YOUR_VALUE --env STORE_IMAGES=YOUR_VALUE --env EMBED_TITLE_PREFIX=YOUR_VALUE --env EMBED_HEADING_PREFIX=YOUR_VALUE --env RAG_DEVICE=YOUR_VALUE --env RAG_DTYPE=YOUR_VALUE --env RAG_HYBRID_WEIGHT=YOUR_VALUE --env RAG_RERANK_CMD=YOUR_VALUE --env RAG_RERANK_TIMEOUT_MS=YOUR_VALUE io-github-shinpr-mcp-local-rag -- npx -y mcp-local-rag
```
配置文件 ~/.codex/config.toml：
```toml
[mcp_servers.io-github-shinpr-mcp-local-rag]
command = "npx"
args = ["-y","mcp-local-rag"]

[mcp_servers.io-github-shinpr-mcp-local-rag.env]
BASE_DIR = "YOUR_VALUE"
BASE_DIRS = "YOUR_VALUE"
IGNORE_PATHS = "YOUR_VALUE"
DB_PATH = "YOUR_VALUE"
CACHE_DIR = "YOUR_VALUE"
HF_ENDPOINT = "YOUR_VALUE"
MODEL_NAME = "YOUR_VALUE"
MAX_FILE_SIZE = "YOUR_VALUE"
RAG_MAX_DISTANCE = "YOUR_VALUE"
RAG_GROUPING = "YOUR_VALUE"
RAG_MAX_FILES = "YOUR_VALUE"
CHUNK_MIN_LENGTH = "YOUR_VALUE"
STORE_IMAGES = "YOUR_VALUE"
EMBED_TITLE_PREFIX = "YOUR_VALUE"
EMBED_HEADING_PREFIX = "YOUR_VALUE"
RAG_DEVICE = "YOUR_VALUE"
RAG_DTYPE = "YOUR_VALUE"
RAG_HYBRID_WEIGHT = "YOUR_VALUE"
RAG_RERANK_CMD = "YOUR_VALUE"
RAG_RERANK_TIMEOUT_MS = "YOUR_VALUE"
```
需要环境变量：BASE_DIR, BASE_DIRS, IGNORE_PATHS, DB_PATH, CACHE_DIR, HF_ENDPOINT, MODEL_NAME, MAX_FILE_SIZE, RAG_MAX_DISTANCE, RAG_GROUPING, RAG_MAX_FILES, CHUNK_MIN_LENGTH, STORE_IMAGES, EMBED_TITLE_PREFIX, EMBED_HEADING_PREFIX, RAG_DEVICE, RAG_DTYPE, RAG_HYBRID_WEIGHT, RAG_RERANK_CMD, RAG_RERANK_TIMEOUT_MS

### Cursor
配置文件 .cursor/mcp.json：
```json
{
  "mcpServers": {
    "io-github-shinpr-mcp-local-rag": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-local-rag"
      ],
      "env": {
        "BASE_DIR": "YOUR_VALUE",
        "BASE_DIRS": "YOUR_VALUE",
        "IGNORE_PATHS": "YOUR_VALUE",
        "DB_PATH": "YOUR_VALUE",
        "CACHE_DIR": "YOUR_VALUE",
        "HF_ENDPOINT": "YOUR_VALUE",
        "MODEL_NAME": "YOUR_VALUE",
        "MAX_FILE_SIZE": "YOUR_VALUE",
        "RAG_MAX_DISTANCE": "YOUR_VALUE",
        "RAG_GROUPING": "YOUR_VALUE",
        "RAG_MAX_FILES": "YOUR_VALUE",
        "CHUNK_MIN_LENGTH": "YOUR_VALUE",
        "STORE_IMAGES": "YOUR_VALUE",
        "EMBED_TITLE_PREFIX": "YOUR_VALUE",
        "EMBED_HEADING_PREFIX": "YOUR_VALUE",
        "RAG_DEVICE": "YOUR_VALUE",
        "RAG_DTYPE": "YOUR_VALUE",
        "RAG_HYBRID_WEIGHT": "YOUR_VALUE",
        "RAG_RERANK_CMD": "YOUR_VALUE",
        "RAG_RERANK_TIMEOUT_MS": "YOUR_VALUE"
      }
    }
  }
}
```
一键安装：cursor://anysphere.cursor-deeplink/mcp/install?name=io-github-shinpr-mcp-local-rag&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIm1jcC1sb2NhbC1yYWciXSwiZW52Ijp7IkJBU0VfRElSIjoiWU9VUl9WQUxVRSIsIkJBU0VfRElSUyI6IllPVVJfVkFMVUUiLCJJR05PUkVfUEFUSFMiOiJZT1VSX1ZBTFVFIiwiREJfUEFUSCI6IllPVVJfVkFMVUUiLCJDQUNIRV9ESVIiOiJZT1VSX1ZBTFVFIiwiSEZfRU5EUE9JTlQiOiJZT1VSX1ZBTFVFIiwiTU9ERUxfTkFNRSI6IllPVVJfVkFMVUUiLCJNQVhfRklMRV9TSVpFIjoiWU9VUl9WQUxVRSIsIlJBR19NQVhfRElTVEFOQ0UiOiJZT1VSX1ZBTFVFIiwiUkFHX0dST1VQSU5HIjoiWU9VUl9WQUxVRSIsIlJBR19NQVhfRklMRVMiOiJZT1VSX1ZBTFVFIiwiQ0hVTktfTUlOX0xFTkdUSCI6IllPVVJfVkFMVUUiLCJTVE9SRV9JTUFHRVMiOiJZT1VSX1ZBTFVFIiwiRU1CRURfVElUTEVfUFJFRklYIjoiWU9VUl9WQUxVRSIsIkVNQkVEX0hFQURJTkdfUFJFRklYIjoiWU9VUl9WQUxVRSIsIlJBR19ERVZJQ0UiOiJZT1VSX1ZBTFVFIiwiUkFHX0RUWVBFIjoiWU9VUl9WQUxVRSIsIlJBR19IWUJSSURfV0VJR0hUIjoiWU9VUl9WQUxVRSIsIlJBR19SRVJBTktfQ01EIjoiWU9VUl9WQUxVRSIsIlJBR19SRVJBTktfVElNRU9VVF9NUyI6IllPVVJfVkFMVUUifX0
需要环境变量：BASE_DIR, BASE_DIRS, IGNORE_PATHS, DB_PATH, CACHE_DIR, HF_ENDPOINT, MODEL_NAME, MAX_FILE_SIZE, RAG_MAX_DISTANCE, RAG_GROUPING, RAG_MAX_FILES, CHUNK_MIN_LENGTH, STORE_IMAGES, EMBED_TITLE_PREFIX, EMBED_HEADING_PREFIX, RAG_DEVICE, RAG_DTYPE, RAG_HYBRID_WEIGHT, RAG_RERANK_CMD, RAG_RERANK_TIMEOUT_MS