# 安装 io.github.cyanheads/obsidian-mcp-server

- 类型: MCP 工具
- 说明: 连接 Obsidian 笔记库，批量读写、检索并精确编辑笔记与元数据。
- 仓库: https://github.com/cyanheads/obsidian-mcp-server
- ⚠ 安全: 这是一个官方 Registry 上架、开源且有一定社区采用的 Obsidian MCP 工具，整体供应链可信度较好。其主要风险点来自典型工具能力：需要 Obsidian API 配置、可执行本地代码、并可按配置读写笔记数据，当前材料未见明显高风险红旗。

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

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

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

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

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

### Claude Code
```bash
claude mcp add --env OBSIDIAN_API_KEY=YOUR_VALUE --env OBSIDIAN_BASE_URL=YOUR_VALUE --env OBSIDIAN_VERIFY_SSL=YOUR_VALUE --env OBSIDIAN_REQUEST_TIMEOUT_MS=YOUR_VALUE --env OBSIDIAN_ENABLE_COMMANDS=YOUR_VALUE --env OBSIDIAN_READ_PATHS=YOUR_VALUE --env OBSIDIAN_WRITE_PATHS=YOUR_VALUE --env OBSIDIAN_READ_ONLY=YOUR_VALUE --env OBSIDIAN_DELETE_ELICITATION=YOUR_VALUE --env OBSIDIAN_OMNISEARCH_URL=YOUR_VALUE --env MCP_LOG_LEVEL=YOUR_VALUE --transport stdio io-github-cyanheads-obsidian-mcp-server -- npx -y obsidian-mcp-server
```
需要环境变量：OBSIDIAN_API_KEY, OBSIDIAN_BASE_URL, OBSIDIAN_VERIFY_SSL, OBSIDIAN_REQUEST_TIMEOUT_MS, OBSIDIAN_ENABLE_COMMANDS, OBSIDIAN_READ_PATHS, OBSIDIAN_WRITE_PATHS, OBSIDIAN_READ_ONLY, OBSIDIAN_DELETE_ELICITATION, OBSIDIAN_OMNISEARCH_URL, MCP_LOG_LEVEL

### Codex
```bash
codex mcp add --env OBSIDIAN_API_KEY=YOUR_VALUE --env OBSIDIAN_BASE_URL=YOUR_VALUE --env OBSIDIAN_VERIFY_SSL=YOUR_VALUE --env OBSIDIAN_REQUEST_TIMEOUT_MS=YOUR_VALUE --env OBSIDIAN_ENABLE_COMMANDS=YOUR_VALUE --env OBSIDIAN_READ_PATHS=YOUR_VALUE --env OBSIDIAN_WRITE_PATHS=YOUR_VALUE --env OBSIDIAN_READ_ONLY=YOUR_VALUE --env OBSIDIAN_DELETE_ELICITATION=YOUR_VALUE --env OBSIDIAN_OMNISEARCH_URL=YOUR_VALUE --env MCP_LOG_LEVEL=YOUR_VALUE io-github-cyanheads-obsidian-mcp-server -- npx -y obsidian-mcp-server
```
配置文件 ~/.codex/config.toml：
```toml
[mcp_servers.io-github-cyanheads-obsidian-mcp-server]
command = "npx"
args = ["-y","obsidian-mcp-server"]

[mcp_servers.io-github-cyanheads-obsidian-mcp-server.env]
OBSIDIAN_API_KEY = "YOUR_VALUE"
OBSIDIAN_BASE_URL = "YOUR_VALUE"
OBSIDIAN_VERIFY_SSL = "YOUR_VALUE"
OBSIDIAN_REQUEST_TIMEOUT_MS = "YOUR_VALUE"
OBSIDIAN_ENABLE_COMMANDS = "YOUR_VALUE"
OBSIDIAN_READ_PATHS = "YOUR_VALUE"
OBSIDIAN_WRITE_PATHS = "YOUR_VALUE"
OBSIDIAN_READ_ONLY = "YOUR_VALUE"
OBSIDIAN_DELETE_ELICITATION = "YOUR_VALUE"
OBSIDIAN_OMNISEARCH_URL = "YOUR_VALUE"
MCP_LOG_LEVEL = "YOUR_VALUE"
```
需要环境变量：OBSIDIAN_API_KEY, OBSIDIAN_BASE_URL, OBSIDIAN_VERIFY_SSL, OBSIDIAN_REQUEST_TIMEOUT_MS, OBSIDIAN_ENABLE_COMMANDS, OBSIDIAN_READ_PATHS, OBSIDIAN_WRITE_PATHS, OBSIDIAN_READ_ONLY, OBSIDIAN_DELETE_ELICITATION, OBSIDIAN_OMNISEARCH_URL, MCP_LOG_LEVEL

### Cursor
配置文件 .cursor/mcp.json：
```json
{
  "mcpServers": {
    "io-github-cyanheads-obsidian-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-server"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "YOUR_VALUE",
        "OBSIDIAN_BASE_URL": "YOUR_VALUE",
        "OBSIDIAN_VERIFY_SSL": "YOUR_VALUE",
        "OBSIDIAN_REQUEST_TIMEOUT_MS": "YOUR_VALUE",
        "OBSIDIAN_ENABLE_COMMANDS": "YOUR_VALUE",
        "OBSIDIAN_READ_PATHS": "YOUR_VALUE",
        "OBSIDIAN_WRITE_PATHS": "YOUR_VALUE",
        "OBSIDIAN_READ_ONLY": "YOUR_VALUE",
        "OBSIDIAN_DELETE_ELICITATION": "YOUR_VALUE",
        "OBSIDIAN_OMNISEARCH_URL": "YOUR_VALUE",
        "MCP_LOG_LEVEL": "YOUR_VALUE"
      }
    }
  }
}
```
一键安装：cursor://anysphere.cursor-deeplink/mcp/install?name=io-github-cyanheads-obsidian-mcp-server&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIm9ic2lkaWFuLW1jcC1zZXJ2ZXIiXSwiZW52Ijp7Ik9CU0lESUFOX0FQSV9LRVkiOiJZT1VSX1ZBTFVFIiwiT0JTSURJQU5fQkFTRV9VUkwiOiJZT1VSX1ZBTFVFIiwiT0JTSURJQU5fVkVSSUZZX1NTTCI6IllPVVJfVkFMVUUiLCJPQlNJRElBTl9SRVFVRVNUX1RJTUVPVVRfTVMiOiJZT1VSX1ZBTFVFIiwiT0JTSURJQU5fRU5BQkxFX0NPTU1BTkRTIjoiWU9VUl9WQUxVRSIsIk9CU0lESUFOX1JFQURfUEFUSFMiOiJZT1VSX1ZBTFVFIiwiT0JTSURJQU5fV1JJVEVfUEFUSFMiOiJZT1VSX1ZBTFVFIiwiT0JTSURJQU5fUkVBRF9PTkxZIjoiWU9VUl9WQUxVRSIsIk9CU0lESUFOX0RFTEVURV9FTElDSVRBVElPTiI6IllPVVJfVkFMVUUiLCJPQlNJRElBTl9PTU5JU0VBUkNIX1VSTCI6IllPVVJfVkFMVUUiLCJNQ1BfTE9HX0xFVkVMIjoiWU9VUl9WQUxVRSJ9fQ
需要环境变量：OBSIDIAN_API_KEY, OBSIDIAN_BASE_URL, OBSIDIAN_VERIFY_SSL, OBSIDIAN_REQUEST_TIMEOUT_MS, OBSIDIAN_ENABLE_COMMANDS, OBSIDIAN_READ_PATHS, OBSIDIAN_WRITE_PATHS, OBSIDIAN_READ_ONLY, OBSIDIAN_DELETE_ELICITATION, OBSIDIAN_OMNISEARCH_URL, MCP_LOG_LEVEL