# apic-docs-mcp

> **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

```bash
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`)에 추가:

```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` 생성:

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

### Claude Desktop

`claude_desktop_config.json`에 추가:

```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