AgentHubAgentHub

Obsidian Vault MCP Server

MCP ServerMCP Registry官方收录

io.github.OleksandrKucherenko/mcp-obsidian-via-rest · v1.3.3

Access Obsidian vaults via Local REST API - read, search, and interact with notes

概览

Obsidian Vault MCP Server 是一个MCP Server,收录自 官方 MCP Registry。支持 stdio、streamable-http 传输。本页提供 Cursor、Claude Code 等客户端的安装配置片段。

安装

选择你的平台查看安装方式

{
  "mcpServers": {
    "mcp-obsidian-via-rest": {
      "command": "npx",
      "args": [
        "-y",
        "@oleksandrkucherenko/mcp-obsidian"
      ],
      "env": {
        "API_KEY": "<API_KEY>",
        "API_URLS": "<API_URLS>"
      }
    }
  }
}

环境变量

API_KEY必填secret

Obsidian Local REST API key

API_URLS必填

JSON array or semicolon-separated list of Obsidian REST API URLs for failover

API_HOST可选

Obsidian REST API host (legacy single-URL config)

API_PORT可选

Obsidian REST API port (legacy single-URL config)

API_KEY必填secret

Obsidian Local REST API key

API_URLS必填

JSON array or semicolon-separated list of Obsidian REST API URLs for failover

MCP_TRANSPORTS可选

Enabled transports (default: stdio,http)

MCP_HTTP_PORT可选

HTTP transport bind port (default: 3000)

MCP_HTTP_HOST可选

HTTP transport bind host (default: 0.0.0.0)

MCP_HTTP_TOKEN可选secret

Bearer token for HTTP transport authentication

API_KEY必填secret

Obsidian Local REST API key

API_URLS必填

JSON array of Obsidian REST API URLs (use host.docker.internal for local Obsidian)

MCP_TRANSPORTS可选

Enabled transports (default: stdio,http)

MCP_HTTP_PORT可选

HTTP transport bind port (default: 3000)

MCP_HTTP_TOKEN可选secret

Bearer token for HTTP transport authentication

API_KEY必填secret

Obsidian Local REST API key

API_URLS必填

JSON array of Obsidian REST API URLs (use host.docker.internal for local Obsidian)

MCP_TRANSPORTS可选

Enabled transports (default: stdio,http)

MCP_HTTP_PORT可选

HTTP transport bind port (default: 3000)

MCP_HTTP_TOKEN可选secret

Bearer token for HTTP transport authentication

相关资源

统一 Manifest

{
  "id": "io.github.OleksandrKucherenko/mcp-obsidian-via-rest",
  "type": "mcp-server",
  "version": "1.3.3",
  "displayName": "Obsidian Vault MCP Server",
  "description": "Access Obsidian vaults via Local REST API - read, search, and interact with notes",
  "repository": {
    "url": "https://github.com/OleksandrKucherenko/mcp-obsidian-via-rest",
    "source": "github"
  },
  "homepage": "https://github.com/OleksandrKucherenko/mcp-obsidian-via-rest#readme",
  "distribution": {
    "packages": [
      {
        "registryType": "npm",
        "identifier": "@oleksandrkucherenko/mcp-obsidian",
        "version": "1.3.3",
        "runtimeHint": "npx",
        "transport": "stdio",
        "environmentVariables": [
          {
            "name": "API_KEY",
            "description": "Obsidian Local REST API key",
            "isRequired": true,
            "isSecret": true
          },
          {
            "name": "API_URLS",
            "description": "JSON array or semicolon-separated list of Obsidian REST API URLs for failover",
            "isRequired": true
          },
          {
            "name": "API_HOST",
            "description": "Obsidian REST API host (legacy single-URL config)"
          },
          {
            "name": "API_PORT",
            "description": "Obsidian REST API port (legacy single-URL config)"
          }
        ]
      },
      {
        "registryType": "npm",
        "identifier": "@oleksandrkucherenko/mcp-obsidian",
        "version": "1.3.3",
        "runtimeHint": "npx",
        "transport": "streamable-http",
        "environmentVariables": [
          {
            "name": "API_KEY",
            "description": "Obsidian Local REST API key",
            "isRequired": true,
            "isSecret": true
          },
          {
            "name": "API_URLS",
            "description": "JSON array or semicolon-separated list of Obsidian REST API URLs for failover",
            "isRequired": true
          },
          {
            "name": "MCP_TRANSPORTS",
            "description": "Enabled transports (default: stdio,http)"
          },
          {
            "name": "MCP_HTTP_PORT",
            "description": "HTTP transport bind port (default: 3000)"
          },
          {
            "name": "MCP_HTTP_HOST",
            "description": "HTTP transport bind host (default: 0.0.0.0)"
          },
          {
            "name": "MCP_HTTP_TOKEN",
            "description": "Bearer token for HTTP transport authentication",
            "isSecret": true
          }
        ]
      },
      {
        "registryType": "oci",
        "identifier": "ghcr.io/oleksandrkucherenko/obsidian-mcp:1.3.3",
        "runtimeHint": "docker",
        "transport": "streamable-http",
        "environmentVariables": [
          {
            "name": "API_KEY",
            "description": "Obsidian Local REST API key",
            "isRequired": true,
            "isSecret": true
          },
          {
            "name": "API_URLS",
            "description": "JSON array of Obsidian REST API URLs (use host.docker.internal for local Obsidian)",
            "isRequired": true
          },
          {
            "name": "MCP_TRANSPORTS",
            "description": "Enabled transports (default: stdio,http)"
          },
          {
            "name": "MCP_HTTP_PORT",
            "description": "HTTP transport bind port (default: 3000)"
          },
          {
            "name": "MCP_HTTP_TOKEN",
            "description": "Bearer token for HTTP transport authentication",
            "isSecret": true
          }
        ]
      },
      {
        "registryType": "oci",
        "identifier": "docker.io/oleksandrkucherenko/obsidian-mcp:1.3.3",
        "runtimeHint": "docker",
        "transport": "streamable-http",
        "environmentVariables": [
          {
            "name": "API_KEY",
            "description": "Obsidian Local REST API key",
            "isRequired": true,
            "isSecret": true
          },
          {
            "name": "API_URLS",
            "description": "JSON array of Obsidian REST API URLs (use host.docker.internal for local Obsidian)",
            "isRequired": true
          },
          {
            "name": "MCP_TRANSPORTS",
            "description": "Enabled transports (default: stdio,http)"
          },
          {
            "name": "MCP_HTTP_PORT",
            "description": "HTTP transport bind port (default: 3000)"
          },
          {
            "name": "MCP_HTTP_TOKEN",
            "description": "Bearer token for HTTP transport authentication",
            "isSecret": true
          }
        ]
      }
    ],
    "remotes": []
  },
  "dependencies": [],
  "installTargets": [
    "claude-code",
    "claude-desktop",
    "cursor",
    "vscode"
  ],
  "keywords": [],
  "provenance": {
    "origin": "official-mcp-registry",
    "originalId": "io.github.OleksandrKucherenko/mcp-obsidian-via-rest",
    "originalUrl": "https://registry.modelcontextprotocol.io/v0.1/servers/io.github.OleksandrKucherenko%2Fmcp-obsidian-via-rest/versions/latest",
    "isOfficial": true,
    "status": "active"
  }
}
Obsidian Vault MCP Server — MCP Server 安装与配置 · AgentHub