Obsidian MCP 3218e624

MCP文档知识

提供方 aleksakarac

文档知识 stdio · 本地进程 无需鉴权 社区 / 第三方 Claude
查看接入方式

一个为Obsidian设计的全面MCP服务器,提供45种工具,支持混合文件系统原生和API架构,包括插件控制、反向链接、标签管理和分析功能。

一句话选型结论

按资料字段整理

Obsidian MCP 3218e624 属于文档知识类 MCP 服务器,stdio · 本地进程,无需鉴权,可直接接入 Claude,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类文档知识 传输方式stdio · 本地进程 鉴权无需鉴权 部署方式本地部署
GitHub 星标 8 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

文档知识
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

笔记管理Python本地部署文件系统工具API集成标签管理反向链接分析任务管理

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
python --version

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Python,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
文档检索问答

在你的文档库里按问题找答案。

知识库读写

把新资料写进知识库,随用随取。

内容整理

把零散资料归纳成结构化笔记。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在文档知识场景里让模型直接调用外部能力的人。
  • 已经在用 Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Obsidian MCP 3218e624当前 未标注 stdio · 本地进程 本地部署 有 2026-05-17
dify 未标注 stdio · 本地进程 本地部署 有 2026-04-11
open-webui 未标注 stdio · 本地进程 本地部署 有 2026-04-11
JeecgBoot 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Cherry Studio 未标注 未标注 未标注 无 2026-05-17
mempalace 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

文档知识
字段来自项目仓库与公开索引,中文说明由本站标注
提供方aleksakarac上游标注的维护方 aleksakarac
分类文档知识本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Python本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

10.2 KB
来自项目仓库与上游目录的原文,未做删改

Obsidian MCP Extended

A comprehensive MCP server for Obsidian with 45 tools across hybrid filesystem-native and API-based architectures. Extends obsidian-mcp with advanced plugin control, backlinks, tag management, and analytics.

> Note: This project extends the base obsidian-mcp server. The original README is preserved as README.upstream.md.

🌟 Features

Hybrid Architecture

Filesystem-Native Tools (33 tools) - Work completely offline, no Obsidian required:
- ✅ Direct file access for maximum performance
- ✅ Zero Obsidian plugins needed
- ✅ Instant startup, minimal memory
- ✅ Full offline capability

API-Based Tools (12 tools) - Enhanced features when Obsidian is running:
- 🔌 Real-time workspace control
- 🔌 Advanced plugin integration (Templater, Dataview DQL)
- 🔌 Command palette access
- 🔌 Requires Local REST API plugin


📦 Complete Tool List (45 Tools)

🔗 Backlink Analysis (2 tools - Filesystem)

  • get_backlinks_fs - Find all notes linking to a specific note
  • get_broken_links_fs - Identify broken wikilinks in vault

🏷️ Tag Management (4 tools - Filesystem)

  • analyze_note_tags_fs - Extract frontmatter and inline tags
  • add_tag_fs - Add tags to note frontmatter
  • remove_tag_fs - Remove tags from frontmatter
  • search_by_tag_fs - Find notes by tag

✏️ Smart Content Insertion (4 tools - Filesystem)

  • insert_after_heading_fs - Insert content after specific headings
  • insert_after_block_fs - Insert after block references
  • update_frontmatter_field_fs - Update/add frontmatter fields
  • append_to_note_fs - Append content to note end

📊 Statistics & Analytics (2 tools - Filesystem)

  • note_statistics_fs - Comprehensive stats for individual notes
  • vault_statistics_fs - Aggregate vault statistics

✅ Tasks Plugin (5 tools - Filesystem)

  • search_tasks - Search tasks with emoji metadata (📅⏫🔁✅)
  • create_task - Create tasks with metadata
  • toggle_task_status - Toggle complete/incomplete
  • update_task_metadata - Update due dates, priority, recurrence
  • get_task_statistics - Task completion analytics

📊 Dataview Inline Fields (4 tools - Filesystem)

  • extract_dataview_fields - Parse all syntax variants (::, [], ())
  • search_by_dataview_field - Find notes by field values
  • add_dataview_field - Add inline fields
  • remove_dataview_field - Remove inline fields

📋 Kanban Boards (5 tools - Filesystem)

  • parse_kanban_board - Parse markdown Kanban structure
  • add_kanban_card - Add cards to columns
  • move_kanban_card - Move cards between columns
  • toggle_kanban_card - Toggle card completion
  • get_kanban_statistics - Board analytics

🔗 Enhanced Link Tracking (5 tools - Filesystem)

  • get_link_graph - Complete vault link graph
  • find_orphaned_notes - Identify isolated notes
  • find_hub_notes - Find highly connected notes
  • analyze_link_health - Vault connectivity metrics
  • get_note_connections - Multi-level connection exploration

🎨 Canvas Files (5 tools - Filesystem)

  • parse_canvas - Parse JSON Canvas v1.0 files
  • add_canvas_node - Add text/file nodes
  • add_canvas_edge - Connect nodes with edges
  • remove_canvas_node - Delete nodes
  • get_canvas_node_connections - Analyze node relationships

📝 Templates (3 tools - Filesystem)

  • expand_template - Simple {{variable}} expansion
  • create_note_from_template_fs - Apply templates offline
  • list_templates - Browse available templates

🔌 Dataview Query API (4 tools - Requires Obsidian + Dataview)

  • execute_dataview_query - Execute full DQL queries (LIST/TABLE/TASK)
  • list_notes_by_tag_dql - DQL tag-based queries
  • list_notes_by_folder_dql - DQL folder queries
  • table_query_dql - Create tabular data views

🔌 Templater Plugin API (3 tools - Requires Obsidian + Templater)

  • render_templater_template - Dynamic template rendering
  • create_note_from_template_api - Create notes from Templater templates
  • insert_templater_template - Insert templates at cursor

🔌 Workspace Management (6 tools - Requires Obsidian)

  • get_active_file - Get currently active file
  • open_file - Open files in Obsidian
  • close_active_file - Close current file
  • navigate_back - Navigate backward in history
  • navigate_forward - Navigate forward in history
  • toggle_edit_mode - Switch edit/preview mode

🔌 Command Execution (3 tools - Requires Obsidian)

  • execute_command - Run Obsidian commands
  • list_commands - List all available commands
  • search_commands - Search commands by name/ID

🚀 Quick Start

Prerequisites```bash

Python 3.11+ required

python --version

Install uv (recommended package manager)

curl -LsSf https://astral.sh/uv/install.sh | sh


### Installation```bash
# Clone repository
git clone https://github.com/aleksakarac/obsidian-mcp.git
cd obsidian-mcp

# Install with uv (recommended)
uv pip install .

# Or with pip
pip install .

Configuration

For Filesystem-Only Tools (No Obsidian Required)

Add to your Claude Code config (~/.config/claude/claude_desktop_config.json):```json
{
"mcpServers": {
"obsidian": {
"command": "uv",
"args": [
"--directory",
"/absolute/path/to/obsidian-mcp",
"run",
"obsidian-mcp"
],
"env": {
"OBSIDIAN_VAULT_PATH": "/path/to/your/obsidian/vault"
}
}
}
}


#### For Full Hybrid Mode (Filesystem + API Tools)

1. Install Local REST API plugin in Obsidian
2. Configure plugin settings:
   - Enable HTTPS: No (use HTTP for localhost)
   - API Key: Generate a secure key
   - Port: 27124 (default)

3. Update Claude Code config:```json
{
  "mcpServers": {
    "obsidian": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/obsidian-mcp",
        "run",
        "obsidian-mcp"
      ],
      "env": {
        "OBSIDIAN_VAULT_PATH": "/path/to/your/obsidian/vault",
        "OBSIDIAN_REST_API_KEY": "your-api-key-here",
        "OBSIDIAN_API_URL": "http://localhost:27124"
      }
    }
  }
}

📖 Usage Examples

Tasks Plugin (Filesystem-Native)```python

Search for high-priority incomplete tasks

search_tasks(
status="incomplete",
priority="high",
sort_by="due_date",
limit=10
)

Create task with metadata

create_task(
file_path="Projects/Current.md",
content="Review PR #123",
priority="high",
due_date="2025-11-01",
tags=["code-review", "urgent"]
)


### Dataview Fields (Filesystem-Native)```python
# Extract all inline fields
extract_dataview_fields(file_path="Project Notes.md")

# Find notes where status=active
search_by_dataview_field(
    field_name="status",
    field_value="active"
)

Kanban Boards (Filesystem-Native)```python

Parse board structure

parse_kanban_board(file_path="Boards/Sprint.md")

Move card between columns

move_kanban_card(
file_path="Boards/Sprint.md",
card_text="Implement authentication",
from_column="To Do",
to_column="In Progress"
)


### Link Analysis (Filesystem-Native)```python
# Find orphaned notes
find_orphaned_notes()

# Get link graph
get_link_graph()

# Analyze vault health
analyze_link_health()

Dataview Queries (Requires Obsidian)```python

Execute DQL query

execute_dataview_query(
query="TABLE status, due FROM #project WHERE status = 'active'"
)


### Workspace Control (Requires Obsidian)```python
# Open file
open_file(file_path="Daily/2025-10-22.md")

# Get active file
get_active_file()

# Execute command
execute_command(command_id="editor:toggle-bold")

🏗️ Architecture

Hybrid Design Philosophy

Filesystem-First Approach:
- Everything that CAN be filesystem-native, IS filesystem-native
- Direct file access for reading/writing markdown
- Zero dependencies on Obsidian plugins for core features
- Full offline capability

API Enhancement:
- API tools complement filesystem tools
- Provide features impossible without Obsidian (workspace UI, command execution)
- Enable plugin integration (Templater, Dataview DQL)
- Graceful degradation with clear error messages

Technology Stack

  • FastMCP: MCP protocol implementation
  • Pydantic: Type-safe data models with validation
  • Python Standard Library: Zero external dependencies for filesystem operations
  • httpx: Async HTTP client for API tools

Performance

Filesystem Tools:
- 1,000 notes: < 3 seconds for full vault scans
- Single note operations: < 100ms
- Link graph generation: < 10 seconds for 1,000 notes

API Tools:
- Command execution: < 500ms
- Query execution: Depends on Dataview plugin
- Workspace operations: < 200ms


🧪 Testing

See TESTING.md for comprehensive testing documentation.```bash

Run all tests

uv run pytest

Run specific test suite

uv run pytest tests/unit/test_tasks.py -v

Run with coverage

uv run pytest --cov=src --cov-report=html


---

## 📝 Development

### Project Structure```
obsidian-mcp/
├── src/
│   ├── models/          # Pydantic data models
│   ├── tools/           # MCP tool implementations
│   ├── utils/           # Shared utilities (patterns, API client)
│   └── server.py        # FastMCP server with tool registrations
├── tests/
│   ├── unit/            # Unit tests for tools
│   └── integration/     # End-to-end workflow tests
├── specs/               # Feature specifications
└── pyproject.toml       # Project configuration

Adding New Tools

  1. Create tool module in src/tools/
  2. Add Pydantic models to src/models/obsidian.py (if needed)
  3. Register tool in src/server.py with @mcp.tool() decorator
  4. Add unit tests in tests/unit/
  5. Update README.md and CHANGELOG.md

🤝 Contributing

Contributions welcome! Please:
1. Follow existing code style
2. Add tests for new features
3. Update documentation
4. Ensure all tests pass


📄 License

MIT License - see LICENSE for details


🙏 Acknowledgments

  • Base implementation: obsidian-mcp
  • MCP Protocol: Model Context Protocol
  • Obsidian: Obsidian.md

📚 Additional Documentation

  • TESTING.md - Testing guide
  • CHANGELOG.md - Version history
  • README.upstream.md - Original obsidian-mcp README
  • specs/ - Feature specifications and design docs

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Obsidian MCP 3218e624 怎么安装?

在客户端按下面的安装命令接入:python --version。装完在客户端配置里引用同一个包或端点。

Obsidian MCP 3218e624 怎么在 Claude 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Obsidian MCP 3218e624 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Obsidian MCP 3218e624 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Obsidian MCP 3218e624 支持哪些客户端?

资料标注支持 Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Obsidian MCP 3218e624 能提供哪些能力?

资料显示能力标签包括 知识管理、标签管理、Python、Claude。具体工具清单以官方文档为准。

Obsidian MCP 3218e624 需要什么运行环境?

运行时为 Python;属于本地进程,需要在本机装好运行环境。

Obsidian MCP 3218e624 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。