Sudoku Solver

🚀 Sudoku Solver MCP Server Project

A MCP server project designed to solve Sudoku problems, offering a note storage system and related utilities.

🚀 Quick Start

📦 Installation

On Claude Desktop

• MacOS: ~/Library/Application\ 支持/Claude/claude_desktop_config.json
• Windows: %APPDATA%/Claude/claude_desktop_config.json

✨ Features

🔍 Resources

The server implements a simple note storage system with the following features:

• A custom note:// URI scheme for accessing individual notes.
• Each note resource includes a name, description, and a content type of text/plain.

💡 Prompts

The server provides a prompt:

• summarize-notes: Generates a summary of all stored notes.
  • An optional "style" parameter to control the level of detail (concise/detailed).
  • Generates a prompt containing the content of all current notes based on style preferences.

🛠️ Tools

The server implements a tool:

• add-note: Adds a new note to the server.
  • Accepts "name" and "content" as required string parameters.
  • Updates the server state and notifies clients of resource changes.

🛠️ Development

🔨 Build and Publish

To prepare a distribution package:

1. Synchronize dependencies and update the lock file:

uv sync

2. Build the package distribution:

uv build

This will create source and wheel format releases in the dist/ directory.

3. Publish to PyPI:

uv publish

Note: You need to set PyPI credentials via environment variables or command-line flags:

• Token: --token or UV_PUBLISH_TOKEN
• Or username/password: --username/UV_PUBLISH_USERNAME and --password/UV_PUBLISH_PASSWORD

🐞 Debugging

Since the MCP server runs via standard input and output, debugging can be challenging. For the best debugging experience, we highly recommend using MCP Inspector.

You can start the MCP inspector via npm with the following command:

npx @modelcontextprotocol/inspector uv --directory /Users/harrisonliang/research/fun/soduku run sodukusolver

After starting, the inspector will display a URL in the browser that you can access to start debugging.

📚 Configuration

[TODO: Add implementation-specific configuration details]