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
git clone https://github.com/Aiden-Kwak/IBM-APIC-DOC-MCP.git
cd apic-docs-mcp
npm install
npm run buildIBM 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
