Apic Docs

Unofficial - IBM과 공식적으로 관련 없는 커뮤니티 프로젝트입니다.

IBM API Connect 12.1.0 공식 문서를 검색하고 조회할 수 있는 비공식 MCP(Model Context Protocol) 서버입니다.

Claude Code, Claude Desktop, IBM Bob 등 MCP를 지원하는 AI 클라이언트에서 사용할 수 있습니다.

Tools

Tool	Description
search_apic_docs	키워드로 문서 검색 (1,000+ 문서, 페이지네이션 지원)
read_apic_doc	특정 문서 페이지를 Markdown으로 조회
get_apic_toc	전체 목차(TOC) 구조 조회 (섹션 필터 가능)

Setup

git clone https://github.com/Aiden-Kwak/IBM-APIC-DOC-MCP.git
cd apic-docs-mcp
npm install
npm run build

IBM Bob

전역 설정(~/.bob/mcp_settings.json) 또는 프로젝트 설정(.bob/mcp.json)에 추가:

{
  "mcpServers": {
    "apic-docs": {
      "command": "node",
      "args": ["/absolute/path/to/apic-docs-mcp/dist/index.js"],
      "alwaysAllow": ["search_apic_docs", "read_apic_doc", "get_apic_toc"]
    }
  }
}

Claude Code

프로젝트 루트에 .mcp.json 생성:

{
  "mcpServers": {
    "apic-docs": {
      "command": "node",
      "args": ["/absolute/path/to/apic-docs-mcp/dist/index.js"]
    }
  }
}

Claude Desktop

claude_desktop_config.json에 추가:

{
  "mcpServers": {
    "apic-docs": {
      "command": "node",
      "args": ["/absolute/path/to/apic-docs-mcp/dist/index.js"]
    }
  }
}

alwaysAllow를 설정하면 도구 사용 시 매번 승인하지 않아도 됩니다.

Usage Examples

"API Connect에서 OAuth 설정하는 방법 알려줘"
"gateway endpoint 관련 문서 찾아줘"
"설치 관련 목차 보여줘"

Tech Stack

• TypeScript + Node.js
• @modelcontextprotocol/sdk - MCP 프로토콜 구현
• jsdom + turndown - HTML to Markdown 변환
• IBM Docs API (ibm.com/docs/api/v1) - 문서 검색 및 조회

License

MIT