manual-works-mcp

ManualWorks 문서 검색을 위한 MCP(Model Context Protocol) 서버입니다.

ManualWorks에 검색 API가 없어서, 문서 목록/내용 API를 조합하여 키워드 검색 기능을 제공합니다.

설치

git clone https://github.com/plainday/manual-works-mcp.git
cd manual-works-mcp

uv 사용 (권장)

uv venv
uv pip install -e .

pip 사용

python -m venv .venv

가상환경 활성화:

# Windows
.venv\Scripts\activate

# macOS / Linux
source .venv/bin/activate

패키지 설치:

pip install -e .

환경변수 설정

이름	설명	예시
MANUALWORKS_BASE_URL	ManualWorks 서버 URL	http://127.0.0.1:1975
MANUALWORKS_API_UUID	API UUID	5b969d63e97cfec7

사용법

MCP Inspector로 테스트

mcp dev src/manual_works_mcp/server.py

Claude Desktop 설정

Claude Desktop 메뉴에서 File > Settings > Developer > Edit Config를 클릭하여 설정 파일을 엽니다.

설정 파일 경로:

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

uv 사용 (권장)

{
  "mcpServers": {
    "manual-works": {
      "command": "uv",
      "args": ["--directory", "/path/to/manual-works-mcp", "run", "-m", "manual_works_mcp.server"],
      "env": {
        "MANUALWORKS_BASE_URL": "http://127.0.0.1:1975",
        "MANUALWORKS_API_UUID": "your-api-uuid"
      }
    }
  }
}

Windows의 경우 경로에 \\를 사용합니다: "C:\\path\\to\\manual-works-mcp"

pip 사용 — Windows

{
  "mcpServers": {
    "manual-works": {
      "command": "C:\\path\\to\\manual-works-mcp\\.venv\\Scripts\\python.exe",
      "args": ["-m", "manual_works_mcp.server"],
      "env": {
        "MANUALWORKS_BASE_URL": "http://127.0.0.1:1975",
        "MANUALWORKS_API_UUID": "your-api-uuid"
      }
    }
  }
}

pip 사용 — macOS / Linux

{
  "mcpServers": {
    "manual-works": {
      "command": "/path/to/manual-works-mcp/.venv/bin/python",
      "args": ["-m", "manual_works_mcp.server"],
      "env": {
        "MANUALWORKS_BASE_URL": "http://127.0.0.1:1975",
        "MANUALWORKS_API_UUID": "your-api-uuid"
      }
    }
  }
}

경로는 실제 clone한 위치로 변경하세요. 설정 후 Claude Desktop을 재시작합니다.

MCP Tools

search_documents

키워드로 ManualWorks 문서를 검색합니다.

• 파라미터: keyword (string) - 검색할 키워드
• 동작: 모든 문서의 장(chapter) 내용을 가져와 키워드 매칭 후 결과를 반환
• 반환: 매칭된 문서 제목, 장 제목, URL, 매칭된 내용 snippet

라이선스

Apache-2.0