广告合作
MCP.so
登录

MCP Obsidian

@OleksandrKucherenko

代码仓库

基本信息

分类

记忆与知识

许可证

MIT license

传输方式

stdio

作者

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

MCP Obsidian 配置

使用下面的配置,将此服务器添加到你的 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\"]"
      }
    }
  }
}

MCP Obsidian 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表，不代表服务没有工具。请查阅项目文档了解支持的能力。

工具是从 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).

常见问题

1

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.

2

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).

3

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.

4

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.

5

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 服务器

Agimem

Persistent memory for AI agents. Hosted MCP server with capsule-scoped key/value storage, tags, TTL expiration, bulk ops, and RBAC.

Neither MCP

stonianua

Project context your AI can query through MCP — with source evidence.

Groundwork

Rarefied-Earth

Groundwork: company memory for your AI tools. Docs public. Source closed. Public proof needs no account.

1

The Cloud

Teka

The Cloud is the AI-native workspace that gives every AI — Claude, ChatGPT, Gemini, and other Frontier & Free or Local models — shared memory and real agents. Not cloud computing: thecloud.so is one workspace where your

ctxfile

ctxfile

Local-first MCP server that snapshots your project's working state into one context object. Open-core, privacy-first.

2
广告合作