Skip to main content
Glama
ri7116

Baekjoon MCP Server

by ri7116
README.md
# Baekjoon MCP Server (beakjoon-mcp)

백준 온라인 저지(BOJ) 문제를 분석하고 사용자에게 힌트, 정답 코드, 테스트 케이스 등을 제공하는 Model Context Protocol (MCP) 서버입니다.

[![ko-badge](https://img.shields.io/badge/Lang-Korean-blue.svg)](https://github.com/ri7116/beakjoon-mcp)

## 사용 가능한 도구 (Available Tools)

| 도구 이름 (Tool Name) | 설명 (Description) | 파라미터 (Parameters) |
| :--- | :--- | :--- |
| `hint` | 문제의 핵심 아이디어와 알고리즘 분류 힌트를 제공합니다. | `problemId` (string \| number): 백준 문제 번호 |
| `answer` | 문제 분석, 복잡도 계산, 최적 정답 코드를 제공합니다. | `problemId` (string \| number): 백준 문제 번호 |
| `testcase` | 엣지 케이스를 포함한 추가 테스트 케이스를 생성합니다. | `problemId` (string \| number): 백준 문제 번호 |
| `refactor` | 사용자 코드를 분석하여 개선된 코드를 제안합니다. | `problemId` (string \| number): 백준 문제 번호<br>`userCode` (string): 사용자가 작성한 코드 |

## MCP 클라이언트 설정 (e.g., Claude Desktop)

Claude Desktop과 같은 MCP 클라이언트에서 이 서버를 사용하려면, 클라이언트의 설정 파일에 아래와 같이 서버 정보를 추가해야 합니다.

**`mcp_servers` 설정 예시:**
```json
{
  "mcpServers": {
    "beakjoon-mcp": {
      "command": "node",
      "args": [
        "C:/Users/your-user/path/to/beakjoon-mcp/dist/index.js"
      ],
      "options": {
        "cwd": "C:/Users/your-user/path/to/beakjoon-mcp"
      }
    }
  }
}
```
> **주의**: `args`와 `cwd`의 경로는 실제 프로젝트가 위치한 절대 경로로 수정해주세요.

TDQS

A3.7/5.0

Scored across 4 tools

Disambiguation5/5

Each tool serves a clearly distinct purpose: hints without code, full solution with code, test case generation, and code refactoring. There is no overlap in functionality, so an agent can easily select the right tool.

Naming Consistency5/5

All tool names are single lowercase words with no separators or mixed conventions. The pattern is consistent and readable, even though they are not verb_noun.

Tool Count5/5

Four tools are well-scoped for a problem-solving assistant. Each tool covers a unique stage of the workflow, and the count is neither too thin nor too heavy.

Completeness4/5

The set covers hinting, solving, testing, and refactoring, which is a complete assistance loop. However, it lacks a tool to retrieve the problem statement itself or to execute code against generated test cases, which are minor gaps.

Maintenance

ActivityInactive
ResponsivenessNo issues