PolarHub
  • Agents
  • MCP Servers
  • Skills
  • PolarBear
PolarHub © 2026
MCP Serversfile-systemsObsidian MCP 服务器
返回「file-systems」

Obsidian MCP 服务器

modelscope·@cyanheads/obsidian-mcp-server

file-systems0下载LocalModelScope

简介

通过模型上下文协议,启用大型语言模型(LLMs)与Obsidian仓库之间的交互,支持安全的文件操作、内容管理和高级搜索功能。

MCP Server 详情

来自 ModelScope 索引

Obsidian MCP 服务器

TypeScript Model Context Protocol Version License Status GitHub

一个为 LLMs 设计的 Model Context Protocol 服务器,用于与 Obsidian 仓库交互。该服务器使用 TypeScript 构建,具备安全的 API 通信、高效的文件操作和全面的搜索功能,使 AI 助手能够通过简洁灵活的工具界面无缝管理知识库。

Model Context Protocol (MCP) 使 AI 模型能够通过标准化接口与外部工具和资源进行交互。

需要在 Obsidian 中启用 Local REST API 插件。

功能

文件操作

  • 带验证的原子文件/目录操作
  • 资源监控和清理
  • 错误处理和优雅失败

搜索系统

  • 可配置上下文的全文搜索
  • 高级 JsonLogic 查询支持文件、标签和元数据
  • 支持 glob 模式和 frontmatter 字段

属性管理

  • YAML frontmatter 解析和智能合并
  • 自动生成时间戳(由 Obsidian 创建,由服务器修改)
  • 自定义字段支持

安全与性能

  • 带速率限制和 SSL 选项的 API 密钥认证
  • 资源监控和健康检查
  • 优雅关闭处理

安装

注意:需要 Node.js

  1. 在 Obsidian 中启用 Local REST API 插件
  2. 克隆并构建:
git clone git@github.com:cyanheads/obsidian-mcp-server.git
cd obsidian-mcp-server
npm install
npm run build

或者从 npm 安装:

npm install obsidian-mcp-server

配置

将以下内容添加到您的 MCP 客户端设置中(例如 claude_desktop_config.json 或 cline_mcp_settings.json):

{
  "mcpServers": {
    "obsidian-mcp-server": {
      "command": "node",
      "args": ["/path/to/obsidian-mcp-server/build/index.js"],
      "env": {
        "OBSIDIAN_API_KEY": "your_api_key_here",
        "VERIFY_SSL": "false",
        "OBSIDIAN_PROTOCOL": "https",
        "OBSIDIAN_HOST": "127.0.0.1",
        "OBSIDIAN_PORT": "27124",
        "REQUEST_TIMEOUT": "5000",
        "MAX_CONTENT_LENGTH": "52428800",
        "MAX_BODY_LENGTH": "52428800",
        "RATE_LIMIT_WINDOW_MS": "900000",
        "RATE_LIMIT_MAX_REQUESTS": "200",
        "TOOL_TIMEOUT_MS": "60000"
      }
    }
  }
}

环境变量:

必需:

  • OBSIDIAN_API_KEY: 从 Obsidian 的 Local REST API 插件设置中获取的 API 密钥

连接设置:

  • VERIFY_SSL: 启用 SSL 证书验证(默认: false) # 对于自签名证书,必须设置为 false。如果您是本地运行或不理解这是什么意思,应将其设置为 false。
  • OBSIDIAN_PROTOCOL: 使用的协议(默认: "https")
  • OBSIDIAN_HOST: 主机地址(默认: "127.0.0.1")
  • OBSIDIAN_PORT: 端口号(默认: 27124)

请求限制:

  • REQUEST_TIMEOUT: 请求超时时间(以毫秒为单位,默认: 5000)
  • MAX_CONTENT_LENGTH: 最大响应内容长度(以字节为单位,默认: 52428800 [50MB])
  • MAX_BODY_LENGTH: 最大请求体长度(以字节为单位,默认: 52428800 [50MB])

速率限制:

  • RATE_LIMIT_WINDOW_MS: 速率限制窗口(以毫秒为单位,默认: 900000 [15 分钟])
  • RATE_LIMIT_MAX_REQUESTS: 每个窗口的最大请求数(默认: 200)

工具执行:

  • TOOL_TIMEOUT_MS: 工具执行超时时间(以毫秒为单位,默认:60000 [1分钟])

项目结构

该项目遵循模块化架构,职责分明:

src/
  ├── index.ts          # Main entry point
  ├── mcp/              # MCP server implementation
  ├── obsidian/         # Obsidian API client and types
  ├── resources/        # MCP resource implementations
  ├── tools/            # MCP tool implementations
  │   ├── files/        # File operations tools
  │   ├── search/       # Search tools
  │   └── properties/   # Property management tools
  └── utils/            # Shared utilities

工具

文件管理

// List vault contents
obsidian_list_files_in_vault: {
}

// List directory contents
obsidian_list_files_in_dir: {
  dirpath: string; // Path relative to vault root
}

// Get file contents
obsidian_get_file_contents: {
  filepath: string; // Path relative to vault root
}

搜索操作

// Text search with context
obsidian_find_in_file: {
  query: string,
  contextLength?: number  // Default: 10
}

// Advanced search with JsonLogic
obsidian_complex_search: {
  query: JsonLogicQuery
  // Examples:
  // Find by tag:
  // {"in": ["#mytag", {"var": "frontmatter.tags"}]}
  //
  // Find markdown files in a directory:
  // {"glob": ["docs/*.md", {"var": "path"}]}
  //
  // Combine conditions:
  // {"and": [
  //   {"glob": ["*.md", {"var": "path"}]},
  //   {"in": ["#mytag", {"var": "frontmatter.tags"}]}
  // ]}
}

// Get all tags in vault or directory
obsidian_get_tags: {
  path?: string  // Optional: limit to specific directory
}

内容修改

// Append to file
obsidian_append_content: {
  filepath: string,  // Path relative to vault root
  content: string    // Content to append
}

// Update file content
obsidian_patch_content: {
  filepath: string,  // Path relative to vault root
  content: string    // New content (replaces existing)
}

属性管理

// Get note properties
obsidian_get_properties: {
  filepath: string  // Path relative to vault root
}

// Update note properties
obsidian_update_properties: {
  filepath: string,  // Path relative to vault root
  properties: {
    title?: string,
    author?: string,
    // Note: created/modified timestamps are managed automatically
    type?: Array<"concept" | "architecture" | "specification" |
      "protocol" | "api" | "research" | "implementation" |
      "guide" | "reference">,
    tags?: string[],  // Must start with #
    status?: Array<"draft" | "in-progress" | "review" | "complete">,
    version?: string,
    platform?: string,
    repository?: string,  // URL
    dependencies?: string[],
    sources?: string[],
    urls?: string[],      // URLs
    papers?: string[],
    custom?: Record<string, unknown>
  }
}

最佳实践

文件操作

  • 使用带有验证的原子操作
  • 处理错误并监控性能

搜索实现

  • 根据任务选择合适的搜索工具:
    • 对于文本搜索使用 obsidian_find_in_file
    • 对于元数据/标签过滤使用 obsidian_complex_search
  • 保持上下文大小合理(默认:10个字符)

属性管理

  • 使用适当的类型并验证更新
  • 正确处理数组和自定义字段
  • 绝不手动设置时间戳(自动管理)

错误预防

  • 验证输入并优雅地处理错误
  • 监控模式并遵守速率限制

资源

MCP 服务器公开以下资源:

obsidian://tags  # List of all tags used across the vault

贡献

  1. 分叉仓库
  2. 创建特性分支
  3. 提交 Pull Request

对于 Bug 和新功能,请在 https://github.com/cyanheads/obsidian-mcp-server/issues 创建问题。

发布

当推送版本标签时,包会自动发布到 npm:

# Update …

相关 MCP Servers(来自「file-systems」)

快递100 MCP Server

快递100 MCP Server提供快递信息查询、快递运费预估比价、快递时效查询(含发货前时效查询与在途动态时效查询)等功能。

kuaidi100/kuaidi100-mcp

墨刀AI-MCP

基于Model Context Protocol的原型生成功能服务,专注于HTML代码生成、设计描述生成和HTML导入功能。

mockingbot/modao-proto-mcp

思维导图 MCP

一个用于生成思维导图的 MCP (Model Context Protocol) 服务器。 看起来您的请求中没有提供具体的英文技术文档内容以供翻译。如果您能分享更多详细信息或具体段落,我将能够帮助您将其准确地翻译成中文,同时保留代码块、链接、格式结构和专业术语的准确性。请提供需要翻译的具体文本。

WEIAIb/mind-map-mcp

文档编辑服务

一个通过模型上下文协议(Model Context Protocol)提供读取、写入和编辑微软Word(docx)文件工具的服务器,允许进行整篇文档读取、内容创建、目标段落编辑以及文本插入等操作。

@famano/mcp-server-office

项目规划器

该工具通过灵活的思维流程帮助分析问题,这种流程能够适应变化并不断演进。随着认知的深入,每个思维节点都可以对先前结论进行补充、质疑或修正。 适用场景 拆解复杂问题为可执行步骤 需要预留修订空间的设计规划 可能需要方向调整的深度分析 初期范围不明确的探索性问题 需多阶段推理的复合型问题 多步骤关联的任务场景 需过滤干扰信息的决策场景

virgo777/sequence_think

用于股票量化计算的智能体

基于Qwen3推理引擎的股票量化智能体,其详细使用方法可通过MCP平台内置的《查询操作手册》获取。 For detailed usage instructions on the Qwen3-powered quantitative trading agent with advanced reasoning capabilities for stock market analysis, please refer to the MCP Query Cookbook accessible via the platform's built-in documentation system.

virgo777/Stock-Quant-Agent

自动安装

点击按钮会唤起 PolarBear 客户端,并把当前 MCP Server 的 Markdown 详情文档地址传给客户端。

/api/mcps/cyanheads-obsidian-mcp-server/markdown
打开 PolarBear 安装查看 Markdown 文档

手动安装

在 PolarBear 或其他支持 MCP 的客户端中,新建 MCP Server,并参考下方来源或安装提示配置。

git clone git@github.com:cyanheads/obsidian-mcp-server.git cd obsidian-mcp-server npm install npm run build

基本信息

分类
file-systems / note-taking / search
运行方式
No
许可证
Apache License 2.0
详情文件
cyanheads-obsidian-mcp-server.md