Marten Docs Server

БесплатноНе проверен

Local MCP server for focused Marten documentation retrieval with caching, search, and progressive narrowing tools.

автор: stijnVanHorenbeek

GitHub Embed

Описание

Local MCP server for focused Marten documentation retrieval with caching, search, and progressive narrowing tools.

README

Local MCP server for focused Marten documentation retrieval.

It caches https://martendb.io/llms-full.txt, builds a local index, and exposes a narrow retrieval surface so agents search first, then progressively narrow to specific sections.

Quick install

macOS / Linux

# Install latest release
curl -fsSL https://raw.githubusercontent.com/stijnVanHorenbeek/marten_mcp/master/scripts/quickinstall.sh | sh

# Print a Copilot-compatible config snippet
curl -fsSL https://raw.githubusercontent.com/stijnVanHorenbeek/marten_mcp/master/scripts/quickinstall.sh | sh -s -- --client copilot

Windows PowerShell

# Install latest release
& ([scriptblock]::Create((irm https://raw.githubusercontent.com/stijnVanHorenbeek/marten_mcp/master/scripts/quickinstall.ps1)))

# Print a Copilot-compatible config snippet
& ([scriptblock]::Create((irm https://raw.githubusercontent.com/stijnVanHorenbeek/marten_mcp/master/scripts/quickinstall.ps1))) -Client copilot

Example SKILL.md

Example SKILL.md is included

MCP config examples

OpenCode

{
  "mcp": {
    "marten-docs": {
      "type": "local",
      "command": ["marten-docs-mcp"],
      "environment": {
        "MARTEN_MCP_CACHE_DIR": "~/.cache/marten-docs-mcp",
        "MARTEN_MCP_STORAGE_MODE": "auto",
        "MARTEN_MCP_SQLITE_PATH": "~/.cache/marten-docs-mcp/cache.db"
      }
    }
  }
}

GitHub Copilot Chat

{
  "mcpServers": {
    "marten-docs": {
      "type": "local",
      "command": "marten-docs-mcp",
      "args": [],
      "env": {
        "MARTEN_MCP_CACHE_DIR": "~/.cache/marten-docs-mcp",
        "MARTEN_MCP_STORAGE_MODE": "auto",
        "MARTEN_MCP_SQLITE_PATH": "~/.cache/marten-docs-mcp/cache.db"
      },
      "tools": ["*"]
    }
  }
}

MCP tools

search_docs(query, limit?, offset?)
search_within_page(path, query, limit?, offset?)
list_headings(path)
read_section(id, segmentIndex?, offset?, maxChars?) (returns one local segment plus compact neighbors.before/after refs)
read_context(id, before?, after?) (nearby refs only)
list_pages(prefix?, limit?) (discovery only when search is insufficient)
get_status()
refresh_docs(force?)

Recommended retrieval flow

search_docs(...)
Narrow with list_headings(...) and/or search_within_page(...)
Read one chunk with read_section(...)
Use read_context(...) only for nearby references

Broad page dumps are intentionally unsupported.

1. search_docs(query="aggregate projections", limit=3)
2. search_within_page(path="/events/projections/aggregate-projections.md", query="lifecycle", limit=3)
3. read_section(id="<id>", offset=0, maxChars=1200)
4. read_context(id="<id>", before=1, after=1)
5. repeat read_section(..., offset=<nextOffset>) while hasMore=true

Companion docs

from github.com/stijnVanHorenbeek/marten_mcp

Установка Marten Docs Server

У этого сервера нет опубликованного пакета — он собирается из исходников. Открой репозиторий и следуй инструкции в README.

▸ github.com/stijnVanHorenbeek/marten_mcp

FAQ