Skip to main content
Glama
Sign In
boj-mcp

boj-mcp

by csh1668
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

BOJ-MCP

npm version License: MIT Release to NPM

백준에 있는 문제를 검색하는 기능을 제공하는 비공식 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을 종료 후 다시 시작합니다.

정상적으로 설치가 되었다면 위와 같이 표시됩니다.

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를 참조하세요.

  • 프로젝트 구조 및 아키텍처

  • 새로운 도구 추가 방법

  • 코드 스타일 가이드

  • 빌드 및 배포 방법

Available Tools

10 tools
analyze-contestAnalyze Contest TrendB

특정 대회(들)의 출제 경향을 분석하는 방법을 안내합니다. 문제 난이도 분포, 자주 출제되는 알고리즘 태그, 대회 준비를 위한 학습 방향을 제시하는 가이드를 제공합니다.

Inputs: contestSlugs (required), compareYears.

list-contestList ContestA

BOJ에 존재하는 대회 목록을 조회합니다. 주의: 2025년에 열린 충남대학교 대회가 있음에도 contest 목록에는 cnu2025가 없을 수도 있습니다. 그럴 때는 cnu와 같이 상위 대회 슬러그를 사용하여 전체 충남대학교 대회를 조회할 수 있습니다.

Inputs: no named parameters.

list-tagAlgorithm Tags ListA

BOJ의 알고리즘 태그 목록을 조회합니다.

Inputs: no named parameters.

recommend-contest-problemsRecommend Contest ProblemsA

목적에 맞는 대회 문제를 추천하는 방법을 안내합니다. 학교 대회, ICPC, 특정 대회 준비 등 목적에 따라 맞춤형 문제 세트를 찾는 가이드를 제공합니다.

Inputs: purpose (required), focusTags, currentTier, problemCount, +1 more.

search-contestSearch ContestA

대회 이름을 이용해서 대회 슬러그를 반환합니다.

Inputs: query (required).

search-problemSearch ProblemA

BOJ 문제를 검색합니다. 알고리즘 태그(#태그)를 사용한 검색 전에는 반드시 'search-tag'나 'list-tag' 도구로 유효한 태그 슬러그/이름을 확인하세요.

Inputs: query (required), sort, direction, userSolved, +1 more.

search-tagSearch Algorithm TagB

태그 이름을 이용해서 태그 슬러그를 반환합니다.

Inputs: query (required).

user-statUser StatA

사용자가 푼 문제 수를 문제 난이도 별로 조회합니다.

Inputs: handle.

user-stat-tagUser Stat TagA

사용자가 푼 문제 수를 알고리즘 태그 별로 조회합니다.

Inputs: handle.

user-top100-problemsUser Top 100 ProblemsA

사용자가 푼 문제 중 문제 수준이 높은 상위 100 문제를 가져옵니다

Inputs: handle.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A3.7/5.0

    Scored across 10 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: tags, contests, problems, and user statistics. Even the two contest guide tools (analyze-contest and recommend-contest-problems) are differentiated by their specific goals (analysis vs. recommendation).

    Naming Consistency4/5

    Most tools follow a hyphenated verb_noun pattern (list-, search-, analyze-, recommend-), but the three user-* tools (user-top100-problems, user-stat, user-stat-tag) deviate by using a noun prefix. The hyphenation convention is consistent, making the deviation minor.

    Tool Count5/5

    With 10 tools, the server is well-scoped for its domain (BOJ), covering tags, contests, problems, and user stats without unnecessary bloat or redundancy.

    Completeness4/5

    Core operations for searching and listing resources are present, but there are minor gaps such as no direct problem-detail fetch or contest-detail fetch. Additionally, two tools are meta-guides rather than direct data operations, slightly limiting direct functionality.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • LeetCode MCP Server

      AHM215
      F
      license
      A
      quality
      D
      maintenance
      An MCP server that provides tools to interact with the LeetCode API, enabling problem fetching, code template generation, and solution execution/submission.
      7
      1
      -

    • cf-mcp-orange

      spr7a
      A
      license
      A
      quality
      D
      maintenance
      A complete, all-in-one MCP server for Codeforces, enabling AI assistants to access user profiles, compare users, search problems, get practice recommendations, and more.
      8
      3
      MIT

    • contest-mcp-server

      ugori2
      F
      license
      Not graded
      quality
      D
      maintenance
      MCP server for searching and retrieving Korean contest information. Provides tools to search contests by keyword/category, get details, list categories, and find deadlines.
      -