Search, extract, and navigate markdown documentation via MCP

{
  "server": "mcp-server-markdown",
  "version": "1.0.0",
  "sdk": "@modelcontextprotocol/[email protected]",
  "transport": "stdio",
  "framing": "ndjson",
  "launch": "npx mcp-server-markdown",
  "tools_count": 6,
  "tools": ["list_files", "search_docs", "get_section", "list_headings", "find_code_blocks", "get_frontmatter"],
  "handshake": [
    {
      "direction": "client→server",
      "message": {
        "jsonrpc": "2.0",
        "id": 1,
        "method": "initialize",
        "params": {
          "protocolVersion": "2024-11-05",
          "capabilities": {},
          "clientInfo": {
            "name": "pathfinder-probe",
            "version": "1.0.0"
          }
        }
      }
    },
    {
      "direction": "server→client",
      "elapsed_ms": 509,
      "message": {
        "result": {
          "protocolVersion": "2024-11-05",
          "capabilities": {
            "tools": {
              "listChanged": true
            }
          },
          "serverInfo": {
            "name": "mcp-server-markdown",
            "version": "1.0.0"
          }
        },
        "jsonrpc": "2.0",
        "id": 1
      }
    }
  ],
  "tool_calls": [
    {
      "tool": "list_files",
      "input": {
        "directory": "/tmp/md-mcp-test/docs"
      },
      "output": "CONTRIBUTING.md
README.md",
      "elapsed_ms": 513
    },
    {
      "tool": "search_docs",
      "input": {
        "directory": "/tmp/md-mcp-test/docs",
        "query": "agent"
      },
      "output": "README.md:3 Tani is the first stop for AI agents — a hub to discover tools.
README.md:28 | /api/agents | GET | List registered agents |",
      "elapsed_ms": 514
    },
    {
      "tool": "list_headings",
      "input": {
        "file": "/tmp/md-mcp-test/docs/README.md"
      },
      "output": "- Tani Project (L1)
  - Architecture (L5)
    - Registry (L9)
    - Exchange (L13)
  - Getting Started (L17)
  - API Reference (L24)",
      "elapsed_ms": 515
    },
    {
      "tool": "find_code_blocks",
      "input": {
        "file": "/tmp/md-mcp-test/docs/CONTRIBUTING.md"
      },
      "output": "--- typescript (L15) ---
// Example test
import { describe, it, expect } from 'vitest'

describe('resolve', () => {
  it('returns ranked surfaces', async () => {
    const result = await resolve({ intent: 'fetch URL' })
    expect(result.surfaces.length).toBeGreaterThan(0)
  })
})",
      "elapsed_ms": 515
    },
    {
      "tool": "get_section",
      "input": {
        "file": "/tmp/md-mcp-test/docs/README.md",
        "heading": "API Reference"
      },
      "output": "## API Reference

| Endpoint | Method | Description |
|----------|--------|-------------|
| /api/agents | GET | List registered agents |
| /api/resolve | POST | Find tools for an intent |
| /api/threads | GET | List exchange threads |",
      "elapsed_ms": 516
    }
  ],
  "total_latency_ms": 516,
  "all_tools_succeeded": true,
  "success_rate": "5/5 = 100%"
}