Sudoku Solver

🚀 数独問題解決MCPサーバープロジェクト

このプロジェクトはMCPサーバーを用いて数独問題を解決するためのものです。

🚀 クイックスタート

📦 インストール

Claude Desktop上でのインストール

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

✨ 主な機能

🔍 リソース

このサーバーはシンプルなノート保存システムを実装しており、以下の機能を備えています。

• 単一のノートにアクセスするためのカスタム note:// URIスキーム
• 各ノートリソースには、名前、説明、および text/plain 形式のコンテンツタイプが含まれます。

💡 ヒント

このサーバーは以下のヒントを提供します。

• summarize-notes：保存されているすべてのノートの要約を生成します。
  • 詳細度を制御するためのオプションの "style" パラメータ（簡潔/詳細）
  • スタイルの好みに応じて、現在のすべてのノート内容を含むヒントを生成します。

🛠️ ツール

このサーバーは以下のツールを実装しています。

• add-note：サーバーに新しいノートを追加します。
  • "name" と "content" を必須の文字列パラメータとして受け取ります。
  • サーバーの状態を更新し、クライアントにリソースの変更を通知します。

📚 ドキュメント

🔧 開発

ビルドと公開

配布パッケージを準備するには、以下の手順を実行します。

1. 依存関係を同期し、ロックファイルを更新します。

uv sync

2. パッケージ配布をビルドします。

uv build

これにより、dist/ ディレクトリにソースコードとホイール形式のリリース版が作成されます。 3. PyPIに公開します。

uv publish

注意: PyPIの認証情報は、環境変数またはコマンドラインフラグを使用して設定する必要があります。

• トークン: --token または UV_PUBLISH_TOKEN
• またはユーザー名/パスワード: --username/UV_PUBLISH_USERNAME および --password/UV_PUBLISH_PASSWORD

デバッグ

MCPサーバーは標準入出力で動作するため、デバッグは難しい場合があります。ベストなデバッグ体験を得るために、MCP Inspector の使用を強くおすすめします。

以下のコマンドを実行することで、npm を通じてMCPインスペクターを起動できます。

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

起動後、インスペクターはブラウザでアクセスできるURLを表示し、デバッグを開始できます。

⚙️ 設定

[TODO：あなたの実装に固有の設定詳細を追加]