MCP Notes Server

Instructions

Implementation Reference

• src/notes/tools/handle_tools.py:25-43 (handler)

  The primary handler function for executing the 'add-note' tool logic, including argument validation, storage interaction, and response formatting.

  async def _handle_add_note(self, arguments: Optional[Dict]) -> List[types.TextContent]:
      """Process note creation requests."""
      if not arguments:
          raise ValueError("Missing arguments")
  
      note_name = arguments.get("name")
      content = arguments.get("content")
  
      if not note_name or not content:
          raise ValueError("Missing name or content")
  
      current_time, content = self.storage.add_note(note_name, content)
      return [
          types.TextContent(
              type="text",
              text=f"Created note '{note_name}' with content: {content}\nCreated at: {current_time}",
          )
      ]

• src/notes/tools/list_tools.py:11-22 (schema)

  The schema definition for the 'add-note' tool, specifying input parameters and requirements for validation.

  types.Tool(
      name="add-note",
      description="Create a new note",
      inputSchema={
          "type": "object",
          "properties": {
              "name": {"type": "string"},
              "content": {"type": "string"},
          },
          "required": ["name", "content"],
      },
  ),

• src/notes/tools/list_tools.py:11-22 (registration)

  The tool registration entry in the list of available tools, including name, description, and schema.

  types.Tool(
      name="add-note",
      description="Create a new note",
      inputSchema={
          "type": "object",
          "properties": {
              "name": {"type": "string"},
              "content": {"type": "string"},
          },
          "required": ["name", "content"],
      },
  ),

• src/notes/storage.py:31-43 (helper)

  Helper method in NoteStorage that performs the actual note addition to the in-memory dict and persists to JSON file.

  def add_note(self, name: str, content: str) -> tuple[str, str]:
      """Add a new note with content and timestamps."""
      if name in self.notes:
          raise ValueError(f"Note '{name}' already exists")
      
      current_time = datetime.now().isoformat()
      self.notes[name] = {
          "content": content,
          "created_at": current_time,
          "modified_at": current_time
      }
      self.save_notes()
      return current_time, content