SGF

You run an MCP SGF Server to process Smart Game Format files, extract game information, and generate visual board diagrams with customizable themes. This server is designed for fast, validated results and easy integration with MCP-compatible clients. You can start it quickly with a single command and connect via MCP to get either metadata about SGF games or diagram images of board positions.

How to use

To use the MCP SGF Server, connect your MCP-compatible client to the server and choose the tool you need. You can request a full game information extraction to obtain players, ranks, results, and basic metadata from an SGF file, or you can request a board diagram that visualizes game positions at a specific move with configurable size, format, and appearance.

How to install

Prerequisites: Node.js is installed on your machine. You should also have a compatible MCP client to communicate with the server.

# Install Node.js from https://nodejs.org/ if needed

# Start the SGF MCP server via NPX (no installation required)
npx mcp-sgf

# Optional: install globally for repeated use (after first run, you can start with the local command)
npm install -g mcp-sgf
mcp-sgf

Configuration and usage notes

The server supports two primary MCP interactions: extracting game information and generating board diagrams from SGF content. Use your MCP client to invoke the desired tool with the required SGF content. Diagrams support multiple output formats and themes, and game information extraction returns structured metadata along with validation results.

{
  "tool": "get-sgf-info",
  "arguments": {
    "sgfContent": "(;FF[4]GM[1]SZ[19]PB[Lee Sedol]PW[AlphaGo]BR[9p]WR[-]KM[7.5]RE[W+R]DT[2016-03-09];B[pd];W[dp];B[cd];W[qp])"
  }
}

Client configuration and examples

If you are configuring a client to run the server, you can start the server via NPX as shown in the example below. The client can spawn the server process and communicate over MCP.

{
  "mcpServers": {
    "sgf": {
      "command": "npx",
      "args": ["mcp-sgf"]
    }
  }
}

Notes on features and performance

This MCP SGF Server emphasizes fast responses and robust validation. Expect quick retrieval of game information and diagram generation with configurable dimensions and formats such as PNG and SVG.

Available tools

get-sgf-info

Extract comprehensive metadata from SGF files including player information, game rules, and results.

get-sgf-diagram

Create visual board diagrams showing game positions with configurable size, theme, and format.