# 安装 Obsidian Hybrid Search

- 类型: MCP 工具
- 说明: 帮助用户在 Obsidian 知识库中进行全文、模糊、语义与关联混合检索。
- 仓库: https://github.com/flowing-abyss/obsidian-hybrid-search

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

### Claude Code
```
请帮我安装 askskill 上的 "Obsidian Hybrid Search" MCP 服务：
执行：claude mcp add io-github-flowing-abyss-obsidian-hybrid-search -- npx -y obsidian-hybrid-search
```

### Codex
```
请帮我安装 askskill 上的 "Obsidian Hybrid Search" MCP 服务：
在 ~/.codex/config.toml 中添加：
[mcp_servers.io-github-flowing-abyss-obsidian-hybrid-search]
command = "npx"
args = ["-y","obsidian-hybrid-search"]
然后重启 Codex 生效
```

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

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

### Claude Code
```bash
claude mcp add --env OBSIDIAN_VAULT_PATH=YOUR_VALUE --env OBSIDIAN_PREFIX=YOUR_VALUE --env OBSIDIAN_IGNORE_PATTERNS=YOUR_VALUE --env OPENAI_API_KEY=YOUR_VALUE --env OPENAI_BASE_URL=YOUR_VALUE --env OPENAI_EMBEDDING_MODEL=YOUR_VALUE --env LOCAL_EMBEDDING_MODEL=YOUR_VALUE --env RERANKER_MODEL=YOUR_VALUE --transport stdio io-github-flowing-abyss-obsidian-hybrid-search -- npx -y obsidian-hybrid-search
```
需要环境变量：OBSIDIAN_VAULT_PATH, OBSIDIAN_PREFIX, OBSIDIAN_IGNORE_PATTERNS, OPENAI_API_KEY, OPENAI_BASE_URL, OPENAI_EMBEDDING_MODEL, LOCAL_EMBEDDING_MODEL, RERANKER_MODEL

### Codex
```bash
codex mcp add --env OBSIDIAN_VAULT_PATH=YOUR_VALUE --env OBSIDIAN_PREFIX=YOUR_VALUE --env OBSIDIAN_IGNORE_PATTERNS=YOUR_VALUE --env OPENAI_API_KEY=YOUR_VALUE --env OPENAI_BASE_URL=YOUR_VALUE --env OPENAI_EMBEDDING_MODEL=YOUR_VALUE --env LOCAL_EMBEDDING_MODEL=YOUR_VALUE --env RERANKER_MODEL=YOUR_VALUE io-github-flowing-abyss-obsidian-hybrid-search -- npx -y obsidian-hybrid-search
```
配置文件 ~/.codex/config.toml：
```toml
[mcp_servers.io-github-flowing-abyss-obsidian-hybrid-search]
command = "npx"
args = ["-y","obsidian-hybrid-search"]

[mcp_servers.io-github-flowing-abyss-obsidian-hybrid-search.env]
OBSIDIAN_VAULT_PATH = "YOUR_VALUE"
OBSIDIAN_PREFIX = "YOUR_VALUE"
OBSIDIAN_IGNORE_PATTERNS = "YOUR_VALUE"
OPENAI_API_KEY = "YOUR_VALUE"
OPENAI_BASE_URL = "YOUR_VALUE"
OPENAI_EMBEDDING_MODEL = "YOUR_VALUE"
LOCAL_EMBEDDING_MODEL = "YOUR_VALUE"
RERANKER_MODEL = "YOUR_VALUE"
```
需要环境变量：OBSIDIAN_VAULT_PATH, OBSIDIAN_PREFIX, OBSIDIAN_IGNORE_PATTERNS, OPENAI_API_KEY, OPENAI_BASE_URL, OPENAI_EMBEDDING_MODEL, LOCAL_EMBEDDING_MODEL, RERANKER_MODEL

### Cursor
配置文件 .cursor/mcp.json：
```json
{
  "mcpServers": {
    "io-github-flowing-abyss-obsidian-hybrid-search": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-hybrid-search"
      ],
      "env": {
        "OBSIDIAN_VAULT_PATH": "YOUR_VALUE",
        "OBSIDIAN_PREFIX": "YOUR_VALUE",
        "OBSIDIAN_IGNORE_PATTERNS": "YOUR_VALUE",
        "OPENAI_API_KEY": "YOUR_VALUE",
        "OPENAI_BASE_URL": "YOUR_VALUE",
        "OPENAI_EMBEDDING_MODEL": "YOUR_VALUE",
        "LOCAL_EMBEDDING_MODEL": "YOUR_VALUE",
        "RERANKER_MODEL": "YOUR_VALUE"
      }
    }
  }
}
```
一键安装：cursor://anysphere.cursor-deeplink/mcp/install?name=io-github-flowing-abyss-obsidian-hybrid-search&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIm9ic2lkaWFuLWh5YnJpZC1zZWFyY2giXSwiZW52Ijp7Ik9CU0lESUFOX1ZBVUxUX1BBVEgiOiJZT1VSX1ZBTFVFIiwiT0JTSURJQU5fUFJFRklYIjoiWU9VUl9WQUxVRSIsIk9CU0lESUFOX0lHTk9SRV9QQVRURVJOUyI6IllPVVJfVkFMVUUiLCJPUEVOQUlfQVBJX0tFWSI6IllPVVJfVkFMVUUiLCJPUEVOQUlfQkFTRV9VUkwiOiJZT1VSX1ZBTFVFIiwiT1BFTkFJX0VNQkVERElOR19NT0RFTCI6IllPVVJfVkFMVUUiLCJMT0NBTF9FTUJFRERJTkdfTU9ERUwiOiJZT1VSX1ZBTFVFIiwiUkVSQU5LRVJfTU9ERUwiOiJZT1VSX1ZBTFVFIn19
需要环境变量：OBSIDIAN_VAULT_PATH, OBSIDIAN_PREFIX, OBSIDIAN_IGNORE_PATTERNS, OPENAI_API_KEY, OPENAI_BASE_URL, OPENAI_EMBEDDING_MODEL, LOCAL_EMBEDDING_MODEL, RERANKER_MODEL