obsidian-mcp (v3.1.1)
Published 2026-05-03 10:25:13 +00:00 by anh_studio
Installation
docker pull forgejo.anh.studio/anh_studio/obsidian-mcp:v3.1.1sha256:57285787fe44ebda5cc934bcc58d896ac46840ba68d5719ba2cd35d1595ff2d8About this package
MCP server for Obsidian vaults — read, write, search, and surgically edit notes, tags, and frontmatter via the Local REST API plugin. STDIO or Streamable HTTP.
Image layers
| # debian.sh --arch 'arm64' out/ 'trixie' '@1775433600' |
| ARG BUN_RUNTIME_TRANSPILER_CACHE_PATH=0 |
| ENV BUN_RUNTIME_TRANSPILER_CACHE_PATH=0 |
| ARG BUN_INSTALL_BIN=/usr/local/bin |
| ENV BUN_INSTALL_BIN=/usr/local/bin |
| COPY docker-entrypoint.sh /usr/local/bin # buildkit |
| COPY /usr/local/bin/bun /usr/local/bin/bun # buildkit |
| RUN |2 BUN_RUNTIME_TRANSPILER_CACHE_PATH=0 BUN_INSTALL_BIN=/usr/local/bin /bin/sh -c mkdir -p /usr/local/bun-node-fallback-bin && ln -s /usr/local/bin/bun /usr/local/bun-node-fallback-bin/node # buildkit |
| ENV PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/local/bun-node-fallback-bin |
| RUN |2 BUN_RUNTIME_TRANSPILER_CACHE_PATH=0 BUN_INSTALL_BIN=/usr/local/bin /bin/sh -c groupadd bun --gid 1000 && useradd bun --uid 1000 --gid bun --shell /bin/sh --create-home && ln -s /usr/local/bin/bun /usr/local/bin/bunx && which bun && which bunx && bun --version # buildkit |
| WORKDIR /home/bun/app |
| ENTRYPOINT ["/usr/local/bin/docker-entrypoint.sh"] |
| CMD ["/usr/local/bin/bun"] |
| WORKDIR /usr/src/app |
| ENV NODE_ENV=production |
| LABEL org.opencontainers.image.title=obsidian-mcp-server |
| LABEL org.opencontainers.image.description=MCP server for Obsidian vaults — read, write, search, and surgically edit notes, tags, and frontmatter via the Local REST API plugin. STDIO or Streamable HTTP. |
| LABEL org.opencontainers.image.source=https://github.com/cyanheads/obsidian-mcp-server |
| LABEL org.opencontainers.image.licenses=Apache-2.0 |
| COPY package.json bun.lock ./ # buildkit |
| RUN /bin/sh -c bun install --production --frozen-lockfile --ignore-scripts # buildkit |
| ARG OTEL_ENABLED=true |
| RUN |1 OTEL_ENABLED=true /bin/sh -c if [ "$OTEL_ENABLED" = "true" ]; then bun add @hono/otel @opentelemetry/instrumentation-http @opentelemetry/exporter-metrics-otlp-http @opentelemetry/exporter-trace-otlp-http @opentelemetry/instrumentation-pino @opentelemetry/resources @opentelemetry/sdk-metrics @opentelemetry/sdk-node @opentelemetry/sdk-trace-node @opentelemetry/semantic-conventions; fi # buildkit |
| COPY /usr/src/app/dist ./dist # buildkit |
| RUN |1 OTEL_ENABLED=true /bin/sh -c mkdir -p /var/log/obsidian-mcp-server && chown -R bun:bun /var/log/obsidian-mcp-server # buildkit |
| USER bun |
| ARG PORT |
| ENV MCP_HTTP_PORT=3010 |
| ENV MCP_HTTP_HOST=0.0.0.0 |
| ENV MCP_TRANSPORT_TYPE=http |
| ENV MCP_SESSION_MODE=stateless |
| ENV MCP_LOG_LEVEL=info |
| ENV LOGS_DIR=/var/log/obsidian-mcp-server |
| ENV MCP_FORCE_CONSOLE_LOGGING=true |
| EXPOSE [3010/tcp] |
| CMD ["bun" "run" "dist/index.js"] |
Labels
| Key | Value |
|---|---|
| org.opencontainers.image.created | 2026-04-20T08:09:54.101Z |
| org.opencontainers.image.description | MCP server for Obsidian vaults — read, write, search, and surgically edit notes, tags, and frontmatter via the Local REST API plugin. STDIO or Streamable HTTP. |
| org.opencontainers.image.licenses | Apache-2.0 |
| org.opencontainers.image.revision | bf2e2cecf27e800962b1e7f03d66278f9d5d2e79 |
| org.opencontainers.image.source | https://github.com/cyanheads/obsidian-mcp-server |
| org.opencontainers.image.title | obsidian-mcp-server |
| org.opencontainers.image.url | https://github.com/oven-sh/bun |
| org.opencontainers.image.version | 1.3.13-slim |