Obsidian MCP (Hslrock)

黑曜石MCP-社区版（HSL）

与Obsidian vault交互 模型上下文协议 （MCP）服务器。可以在Claude Code、Cursor等支持MCP的客户端上查看、创建、修改Obsidian笔记、标签、链接、模板、文件夹等。

这个项目没有人的介入。 只用AI制作而成。, python和 TypeScript 提供两种实施：

快速安装（TypeScript/npm）

npm install -g obsidian-mcp-hsl-ce

从Claude Code添加

claude mcp add-json obsidian '{"type":"stdio","command":"obsidian-mcp-hsl-ce","args":["~/Documents/Obsidian/MyVault"]}'

无需安装（npx）

无需全局安装 npx也可以根据需要自动导入并运行：

claude mcp add-json obsidian '{"type":"stdio","command":"npx","args":["-y","obsidian-mcp-hsl-ce","~/Documents/Obsidian/MyVault"]}'

Cursor/其他MCP客户端

添加到MCP配置文件（JSON）：

{
  "mcpServers": {
    "obsidian": {
      "command": "obsidian-mcp-hsl-ce",
      "args": ["~/Documents/Obsidian/MyVault"]
    }
  }
}

args请将的路径更改为您自己的Obsidian vault路径。

______________________________________________________________________

项目结构

ObsidianMCP/
├── obsidian-mcp-py/    # Python 구현
│   ├── main.py
│   ├── run_server.py
│   ├── settings.py
│   ├── pyproject.toml
│   ├── obsidian/
│   ├── CURSOR_SETUP.md
│   └── CLAUDE_SETUP.md
├── obsidian-mcp-ts/    # TypeScript 구현
│   ├── src/
│   │   ├── main.ts
│   │   ├── settings.ts
│   │   └── obsidian/
│   ├── package.json
│   └── tsconfig.json
└── README.md

______________________________________________________________________

Python版本

要求

• Python 3.11+
• 紫外线 （建议）或pip

安装和运行

cd obsidian-mcp-py

# 의존성 설치
uv sync

# 환경 변수 설정
echo 'OBSIDIAN_VAULT_PATH=/path/to/your/vault' > .env

# MCP 서버 실행 (stdio 모드)
uv run python main.py

# HTTP 서버로 실행 (선택)
uv run python run_server.py --http

MCP客户端设置（Cursor）

{
  "mcpServers": {
    "obsidian": {
      "command": "/path/to/obsidian-mcp-py/.venv/bin/python",
      "args": ["/path/to/obsidian-mcp-py/main.py"],
      "env": {
        "OBSIDIAN_VAULT_PATH": "/path/to/your/vault"
      }
    }
  }
}

有关详细设置，请参阅 CURSOR_SETUP.md 及 CLAUDE_SETUP.md请参考。

______________________________________________________________________

TypeScript版本（npm： obsidian-mcp-hsl-ce)-社区版

安装

# 글로벌 설치 (권장)
npm install -g obsidian-mcp-hsl-ce

# 또는 설치 없이 npx로 실행
npx -y obsidian-mcp-hsl-ce ~/Documents/Obsidian/MyVault

# 또는 소스에서 직접
cd obsidian-mcp-ts
npm install && npm run build

MCP客户端设置（Claude Code/Cursor）

全局安装后，只需将vault路径作为参数传递：

{
  "mcpServers": {
    "obsidian": {
      "command": "obsidian-mcp-hsl-ce",
      "args": ["~/Documents/Obsidian/MyVault"]
    }
  }
}

npx无需全局安装即可使用：

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": ["-y", "obsidian-mcp-hsl-ce", "~/Documents/Obsidian/MyVault"]
    }
  }
}

仍然支持环境变量方法：

{
  "mcpServers": {
    "obsidian": {
      "command": "obsidian-mcp-hsl-ce",
      "env": {
        "OBSIDIAN_VAULT_PATH": "/path/to/your/vault"
      }
    }
  }
}

Vault路径优先级： CLI参数 > 环境变量 > 浏览默认路径

______________________________________________________________________

交付工具（40个）

两个版本都提供相同的工具。

许可证

遵守项目中规定的许可证。