Soduku Solver MCP Server

Instructions

Implementation Reference

• src/sodukusolver/server.py:187-205 (handler)

  The execution logic for the 'add-note' tool. It parses arguments, stores the note in the global 'notes' dictionary, notifies the client of resource changes, and returns a confirmation message.

  if name == "add-note":
      note_name = arguments.get("name")
      content = arguments.get("content")
  
      if not note_name or not content:
          raise ValueError("Missing name or content")
  
      # Update server state
      notes[note_name] = content
  
      # Notify clients that resources have changed
      await server.request_context.session.send_resource_list_changed()
  
      return [
          types.TextContent(
              type="text",
              text=f"Added note '{note_name}' with content: {content}",
          )
      ]

• src/sodukusolver/server.py:131-138 (schema)

  JSON Schema defining the input parameters for the 'add-note' tool: requires 'name' and 'content' as strings.

  inputSchema={
      "type": "object",
      "properties": {
          "name": {"type": "string"},
          "content": {"type": "string"},
      },
      "required": ["name", "content"],
  },

• src/sodukusolver/server.py:129-139 (registration)

  Registration of the 'add-note' tool in the list_tools handler, specifying name, description, and schema.

      name="add-note",
      description="Add a new note",
      inputSchema={
          "type": "object",
          "properties": {
              "name": {"type": "string"},
              "content": {"type": "string"},
          },
          "required": ["name", "content"],
      },
  ),

• src/sodukusolver/server.py:10-11 (helper)

  Global dictionary storing all notes, used by the add-note handler for persistence.

  # Store notes as a simple key-value dict to demonstrate state management
  notes: dict[str, str] = {}