# 安装 io.github.sfrangulov/minirag-mcp

- 类型: MCP 工具
- 说明: Local-first RAG MCP server: hybrid search over a folder of your own documents
- 仓库: https://github.com/sfrangulov/minirag-mcp

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

### Claude Code
```
请帮我安装 askskill 上的 "io.github.sfrangulov/minirag-mcp" MCP 服务：
执行：claude mcp add 'io-github-sfrangulov-minirag-mcp' -- uvx minirag-mcp
```

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

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

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

### Claude Code
```bash
claude mcp add --env BASE_DIR=YOUR_VALUE --env BASE_DIRS=YOUR_VALUE --env DB_PATH=YOUR_VALUE --env CACHE_DIR=YOUR_VALUE --env MODEL_NAME=YOUR_VALUE --env MAX_FILE_SIZE=YOUR_VALUE --env CHUNK_TOKEN_BUDGET=YOUR_VALUE --env RAG_HYBRID_WEIGHT=YOUR_VALUE --env RAG_GROUPING=YOUR_VALUE --env RAG_MAX_DISTANCE=YOUR_VALUE --env RAG_MAX_FILES=YOUR_VALUE --env RAG_INSTRUCTIONS_APPEND=YOUR_VALUE --env ALLOW_PRIVATE_URLS=YOUR_VALUE --transport stdio io-github-sfrangulov-minirag-mcp -- uvx minirag-mcp
```
需要环境变量：BASE_DIR, BASE_DIRS, DB_PATH, CACHE_DIR, MODEL_NAME, MAX_FILE_SIZE, CHUNK_TOKEN_BUDGET, RAG_HYBRID_WEIGHT, RAG_GROUPING, RAG_MAX_DISTANCE, RAG_MAX_FILES, RAG_INSTRUCTIONS_APPEND, ALLOW_PRIVATE_URLS

### Codex
```bash
codex mcp add --env BASE_DIR=YOUR_VALUE --env BASE_DIRS=YOUR_VALUE --env DB_PATH=YOUR_VALUE --env CACHE_DIR=YOUR_VALUE --env MODEL_NAME=YOUR_VALUE --env MAX_FILE_SIZE=YOUR_VALUE --env CHUNK_TOKEN_BUDGET=YOUR_VALUE --env RAG_HYBRID_WEIGHT=YOUR_VALUE --env RAG_GROUPING=YOUR_VALUE --env RAG_MAX_DISTANCE=YOUR_VALUE --env RAG_MAX_FILES=YOUR_VALUE --env RAG_INSTRUCTIONS_APPEND=YOUR_VALUE --env ALLOW_PRIVATE_URLS=YOUR_VALUE io-github-sfrangulov-minirag-mcp -- uvx minirag-mcp
```
配置文件 ~/.codex/config.toml：
```toml
[mcp_servers.io-github-sfrangulov-minirag-mcp]
command = "uvx"
args = ["minirag-mcp"]

[mcp_servers.io-github-sfrangulov-minirag-mcp.env]
BASE_DIR = "YOUR_VALUE"
BASE_DIRS = "YOUR_VALUE"
DB_PATH = "YOUR_VALUE"
CACHE_DIR = "YOUR_VALUE"
MODEL_NAME = "YOUR_VALUE"
MAX_FILE_SIZE = "YOUR_VALUE"
CHUNK_TOKEN_BUDGET = "YOUR_VALUE"
RAG_HYBRID_WEIGHT = "YOUR_VALUE"
RAG_GROUPING = "YOUR_VALUE"
RAG_MAX_DISTANCE = "YOUR_VALUE"
RAG_MAX_FILES = "YOUR_VALUE"
RAG_INSTRUCTIONS_APPEND = "YOUR_VALUE"
ALLOW_PRIVATE_URLS = "YOUR_VALUE"
```
需要环境变量：BASE_DIR, BASE_DIRS, DB_PATH, CACHE_DIR, MODEL_NAME, MAX_FILE_SIZE, CHUNK_TOKEN_BUDGET, RAG_HYBRID_WEIGHT, RAG_GROUPING, RAG_MAX_DISTANCE, RAG_MAX_FILES, RAG_INSTRUCTIONS_APPEND, ALLOW_PRIVATE_URLS

### Cursor
配置文件 .cursor/mcp.json：
```json
{
  "mcpServers": {
    "io-github-sfrangulov-minirag-mcp": {
      "command": "uvx",
      "args": [
        "minirag-mcp"
      ],
      "env": {
        "BASE_DIR": "YOUR_VALUE",
        "BASE_DIRS": "YOUR_VALUE",
        "DB_PATH": "YOUR_VALUE",
        "CACHE_DIR": "YOUR_VALUE",
        "MODEL_NAME": "YOUR_VALUE",
        "MAX_FILE_SIZE": "YOUR_VALUE",
        "CHUNK_TOKEN_BUDGET": "YOUR_VALUE",
        "RAG_HYBRID_WEIGHT": "YOUR_VALUE",
        "RAG_GROUPING": "YOUR_VALUE",
        "RAG_MAX_DISTANCE": "YOUR_VALUE",
        "RAG_MAX_FILES": "YOUR_VALUE",
        "RAG_INSTRUCTIONS_APPEND": "YOUR_VALUE",
        "ALLOW_PRIVATE_URLS": "YOUR_VALUE"
      }
    }
  }
}
```
一键安装：cursor://anysphere.cursor-deeplink/mcp/install?name=io-github-sfrangulov-minirag-mcp&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyJtaW5pcmFnLW1jcCJdLCJlbnYiOnsiQkFTRV9ESVIiOiJZT1VSX1ZBTFVFIiwiQkFTRV9ESVJTIjoiWU9VUl9WQUxVRSIsIkRCX1BBVEgiOiJZT1VSX1ZBTFVFIiwiQ0FDSEVfRElSIjoiWU9VUl9WQUxVRSIsIk1PREVMX05BTUUiOiJZT1VSX1ZBTFVFIiwiTUFYX0ZJTEVfU0laRSI6IllPVVJfVkFMVUUiLCJDSFVOS19UT0tFTl9CVURHRVQiOiJZT1VSX1ZBTFVFIiwiUkFHX0hZQlJJRF9XRUlHSFQiOiJZT1VSX1ZBTFVFIiwiUkFHX0dST1VQSU5HIjoiWU9VUl9WQUxVRSIsIlJBR19NQVhfRElTVEFOQ0UiOiJZT1VSX1ZBTFVFIiwiUkFHX01BWF9GSUxFUyI6IllPVVJfVkFMVUUiLCJSQUdfSU5TVFJVQ1RJT05TX0FQUEVORCI6IllPVVJfVkFMVUUiLCJBTExPV19QUklWQVRFX1VSTFMiOiJZT1VSX1ZBTFVFIn19
需要环境变量：BASE_DIR, BASE_DIRS, DB_PATH, CACHE_DIR, MODEL_NAME, MAX_FILE_SIZE, CHUNK_TOKEN_BUDGET, RAG_HYBRID_WEIGHT, RAG_GROUPING, RAG_MAX_DISTANCE, RAG_MAX_FILES, RAG_INSTRUCTIONS_APPEND, ALLOW_PRIVATE_URLS