tpm-mcp

Instructions

Implementation Reference

• src/tpm_mcp/server.py:706-715 (handler)

  Main tool handler in _handle_tool function. Creates NoteCreate from arguments and calls db.add_note to persist the note, returns confirmation message.

  if name == "note_add":
      note = db.add_note(
          NoteCreate(
              entity_type=args["entity_type"],
              entity_id=args["entity_id"],
              content=args["content"],
          )
      )
      # Return minimal confirmation - note content is echoed back by caller anyway
      return f"Added note {note.id} to {note.entity_type}/{note.entity_id}"

• src/tpm_mcp/server.py:383-398 (registration)

  Tool registration in list_tools() function, including name, description, and JSON input schema matching NoteCreate model.

      name="note_add",
      description="PROJECT MANAGEMENT (TPM): Add a note/comment to a ticket or task for context or decisions.",
      inputSchema={
          "type": "object",
          "properties": {
              "entity_type": {
                  "type": "string",
                  "enum": ["org", "project", "ticket", "task"],
                  "description": "Type of entity",
              },
              "entity_id": {"type": "string", "description": "ID of the entity"},
              "content": {"type": "string", "description": "Note content"},
          },
          "required": ["entity_type", "entity_id", "content"],
      },
  ),

• src/tpm_mcp/db.py:758-772 (schema)

  Database implementation of add_note: generates ID, inserts into 'notes' table using SQL, commits, and returns Note model instance.

  def add_note(self, data: NoteCreate) -> Note:
      id = self._gen_id()
      now = self._now()
      self.conn.execute(
          "INSERT INTO notes (id, entity_type, entity_id, content, created_at) VALUES (?, ?, ?, ?, ?)",
          (id, data.entity_type, data.entity_id, data.content, now),
      )
      self.conn.commit()
      return Note(
          id=id,
          entity_type=data.entity_type,
          entity_id=data.entity_id,
          content=data.content,
          created_at=datetime.fromisoformat(now),
      )

• src/tpm_mcp/models.py:159-162 (schema)

  Pydantic model NoteCreate defining the input structure for note_add tool, used for validation and type hints.

  class NoteCreate(BaseModel):
      entity_type: str
      entity_id: str
      content: str