BOJ-MCP
  
백준에 있는 문제를 검색하는 기능을 제공하는 비공식 MCP입니다.
BOJ-MCP지만, solved.ac의 비공식 API를 사용합니다.
한창 개발 중입니다.
설치 방법
1) npm 사용 (권장)
컴퓨터에 node.js가 설치되어 있어야 합니다.
Claude Desktop
Windows: %APPDATA%\Claude\claude_desktop_config.json
MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
해당 위치에 파일이 없으면 생성합니다.
{
"mcpServers": {
"boj-mcp": {
"command": "npx",
"args": ["-y", "boj-mcp", "--handle=your-handle"]
}
}
}
위 내용을 추가하고 Claude Desktop을 종료 후 다시 시작합니다.
<img width="427" height="446" alt="image" src="https://github.com/user-attachments/assets/e6cd0273-52fe-42a9-93a4-40917c48598b" />
정상적으로 설치가 되었다면 위와 같이 표시됩니다.
Claude Code
claude mcp add boj-mcp -- npx -y boj-mcp
# OR
claude mcp add boj-mcp -- npx -y boj-mcp --handle=your-handle
Codex
codex mcp add boj-mcp -- npx -y boj-mcp
# OR
codex mcp add boj-mcp -- npx -y boj-mcp --handle=your-handle
Gemini Cli
gemini mcp add boj-mcp npx -y boj-mcp
# OR
gemini mcp add boj-mcp npx -y boj-mcp --handle=your-handle
Cursor
Ctrl + Shift + P를 누르고 Open MCP Settings를 찾아 들어갑니다. New MCP Server를 클릭하고 다음 내용을 붙여넣습니다.
{
"mcpServers": {
"boj-mcp": {
"command": "npx",
"args": ["-y", "boj-mcp", "--handle=your-handle"]
}
}
}
2) 로컬 빌드 후 실행
git clone https://github.com/csh1668/boj-mcp
cd boj-mcp
pnpm i
pnpm start
그리고 Cursor 설정에 다음처럼 추가합니다.
{
"mcpServers": {
"boj-mcp": {
"command": "node",
"args": ["dist/index.js"]
}
}
}
사용 방법
설치가 완료되면 AI에게 다음과 같이 질문하여 백준 문제를 검색하거나 추천받을 수 있습니다.
1. 문제 검색
- "골드 5 난이도의 DP 문제 찾아줘"
- "다익스트라 문제 중 푼 사람이 10명 이하인 문제 찾아줘"
2. 문제 추천
- "코딩 테스트 준비를 위해 실버 난이도의 구현 문제 5개 추천해줘"
- "ICPC 예선 대비를 위한 문제 세트 추천해줘"
3. 대회 및 태그 정보
- "UCPC 2023 대회의 출제 경향을 분석해줘"
- "비트마스킹 태그가 붙은 문제들은 어떤 게 있어?"
---
개발자 가이드
프로젝트에 기여하거나 새로운 도구를 추가하고 싶다면 Developer Guide를 참조하세요.
- 프로젝트 구조 및 아키텍처
- 새로운 도구 추가 방법
- 코드 스타일 가이드
- 빌드 및 배포 방법











