MCP.so
登录

mcp-obsidian

@OleksandrKucherenko

代码仓库

关于 mcp-obsidian

MCP Server connected to Obsidian Vault with Local REST API. (re-write it completely with BUN to make it faster and more lightweight)

#obsidian#restapi#dockerized#typescript#docker#npm#bun

基本信息

分类

记忆与知识

许可证

MIT license

运行时

shell

传输方式

stdio

发布者

OleksandrKucherenko

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "obsidian": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "API_KEY",
        "-e",
        "API_URLS",
        "ghcr.io/oleksandrkucherenko/obsidian-mcp:latest"
      ],
      "env": {
        "API_KEY": "<your-obsidian-api-key>",
        "API_URLS": "[\"https://host.docker.internal:27124\"]"
      }
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is mcp-obsidian?

mcp-obsidian is a Model Context Protocol (MCP) server that connects AI assistants to the Obsidian Local REST API, enabling programmatic access to Obsidian notes via a Docker container or local TypeScript runtime.

How to use mcp-obsidian?

Configure the server in your MCP client’s JSON settings with required environment variables (API_KEY, API_HOST, API_PORT). The recommended deployment is via Docker using the image ghcr.io/oleksandrkucherenko/obsidian-mcp:latest. For local development, run bun run src/index.ts with the appropriate config.

Key features of mcp-obsidian

  • Dockerized deployment with automatic container cleanup (--rm).
  • Supports WSL2 and Windows host connectivity.
  • Debug logging via DEBUG=mcp:* environment variable.
  • Works with the Obsidian Local REST API plugin (v3.2.0).
  • Pre‑built Docker images for both the MCP server and a full Obsidian‑with‑VNC container.
  • Cross‑platform compatibility (macOS, Linux, Windows/WSL2).

Use cases of mcp-obsidian

  • Integrate Obsidian note‑taking with AI‑powered tools (e.g., Claude Desktop, Windsurf).
  • Automate note creation, search, and content retrieval via MCP.
  • Test MCP interactions locally without a live Obsidian instance (using the Dockerized Obsidian‑VNC image).

FAQ from mcp-obsidian

What environment variables are required?

API_KEY (your Obsidian Local REST API secret key) is required. API_HOST (default localhost) and API_PORT (default 27124) are optional.

How do I verify the Obsidian REST API is running?

Run curl --insecure https://localhost:27124 or use netstat -an | findstr 27124 on Windows. For WSL2, use the gateway IP (172.26.32.1 by default).

Does mcp‑obsidian support Windows and WSL2?

Yes. The README provides detailed firewall configuration, gateway IP detection, and connectivity tests for WSL2 with Obsidian running on the Windows host.

What is the default port and host for the Obsidian API?

The default host is localhost and the default port is 27124. Override via API_HOST and API_PORT environment variables.

Can the server be run without Docker?

Yes, for development you can run bun run src/index.ts after installing dependencies with bun install. Docker is recommended for production use.

评论

记忆与知识 分类下的更多 MCP 服务器

Memory Bank MCP Server

alioshr

A Model Context Protocol (MCP) server implementation for remote memory bank management, inspired by Cline Memory Bank.

913

Semantic Scholar MCP Server

YUZongmin

A FastMCP server implementation for the Semantic Scholar API, providing comprehensive access to academic paper data, author information, and citation networks.

158

Mcp Knowledge Graph

shaneholloman

MCP server enabling persistent memory for Claude through a local knowledge graph - fork focused on local development

871

🧠 Ultimate MCP Server

Dicklesworthstone

Comprehensive MCP server exposing dozens of capabilities to AI agents: multi-provider LLM delegation, browser automation, document processing, vector ops, and cognitive memory systems

154

Obsidian MCP Server

StevenStavrakis

A simple MCP server for Obsidian

717