mcp-docs

Markdown 문서를 LLM에 노출하여 모든 소프트웨어 문서에 대해 검색하고 질문에 답변할 수 있도록 하는 범용 MCP 서버입니다.

서버 식별자(이름, 지침, 카테고리 레이블)는 전적으로 docs/ 디렉토리에 의해 결정되며, 이는 이 저장소와 함께 복제된 별도의 저장소입니다.

요구 사항

• Python 3.14+

• uv

설정

1. 문서 저장소 복제

서버를 시작하기 전에 docs/ 디렉토리가 존재해야 합니다. 문서 저장소를 해당 디렉토리로 복제하세요:

git clone <docs-repo-url> docs

2. 의존성 설치

uv sync

docs/ 디렉토리 구조

서버는 하위 디렉토리에서 카테고리를 자동으로 검색합니다. 필수 파일은 docs/ 루트에 있는 config.toml뿐입니다.

docs/
├── config.toml          # required — project identity
├── <category>/
│   ├── <topic>.md
│   └── ...
└── <category>/
    └── ...

config.toml

[project]
name = "my-project"
instructions = """
System instructions for the LLM. Describe what this documentation covers
and how the model should use the available tools.
"""

[categories]
folder-name = "Human-readable label"

• **[project]**는 필수입니다. name은 서버를 식별하고, instructions는 LLM을 안내합니다.

• **[categories]**는 선택 사항입니다. 나열되지 않은 하위 디렉토리는 자동으로 제목 대소문자(Title-cased) 레이블이 지정됩니다 (my-folder → My Folder).

• img/ 하위 디렉토리 내의 파일은 제공되지 않습니다.

사용법

서버 실행 (stdio 모드)

uv run main.py

MCP Inspector를 이용한 개발

uv run mcp dev main.py

브라우저에서 MCP Inspector를 엽니다. 실행 중인 SSE 또는 Streamable HTTP 서버에 연결하려면 먼저 서버를 시작하고 출력된 엔드포인트를 인스펙터에 지정하세요:

uv run main.py --transport sse
uv run main.py --transport streamable-http

Claude Desktop 설정

~/Library/Application Support/Claude/claude_desktop_config.json(macOS) 또는 %APPDATA%\Claude\claude_desktop_config.json(Windows)에 추가하세요:

{
  "mcpServers": {
    "my-project": {
      "command": "uv",
      "args": ["--directory", "/path/to/mcp-docs", "run", "main.py"]
    }
  }
}

Claude Code 설정

claude mcp add my-project -- uv --directory /path/to/mcp-docs run main.py

기능

도구

리소스