Christoph Görn cf7d392086 feat: add issue & comment attachment tools (#109 )

Closes #106.

Adds 12 new MCP tools (list/get/download/create/edit/delete × issue +
comment) backed by a new pkg/forgejo/rawhttp.go helper. Download tools
return inline BlobResourceContents under 1 MiB and metadata +
browser_download_url at or above the cap, per the design agreed with
@heathen711 on issue #106.

Includes unit tests, demos, and an e2e script under test/e2e/.

2026-05-02 12:06:54 +02:00

3.5 KiB

Raw Permalink Blame History

Demo: comment attachments — full CRUD

2026-04-26T13:12:00Z

What these tools do

Six MCP tools mirror the issue-attachment tools but operate on issue/PR comment attachments — the same lifecycle (list, get, download, create, edit, delete), keyed by comment_id instead of index:

list_comment_attachments
get_comment_attachment
download_comment_attachment (inline if < 1 MiB; metadata + URL otherwise)
create_comment_attachment
edit_comment_attachment
delete_comment_attachment

Same wire format, same 1 MiB cap, same "always include browser_download_url" contract as the issue-attachment tools. See demos/issue-attachments.md for the design rationale.

Setup

export FORGEJO_URL=https://codeberg.org
export FORGEJO_ACCESS_TOKEN=...
make build

End-to-end lifecycle

1. Create a comment to attach to

./forgejo-mcp --cli create_issue_comment \
  --args '{"owner":"goern","repo":"forgejo-mcp","index":108,"body":"Comment for attachment demo"}'

The response includes the new comment's id — use that as comment_id below.

2. Upload an attachment to the comment

B64=$(base64 -w0 /tmp/snippet.txt)
./forgejo-mcp --cli create_comment_attachment \
  --args "{\"owner\":\"goern\",\"repo\":\"forgejo-mcp\",\"comment_id\":13781165,\"content\":\"$B64\",\"filename\":\"snippet.txt\",\"mime_type\":\"text/plain\"}"

[
  {
    "type": "text",
    "text": "{\"Result\":{\"id\":1174940,\"name\":\"snippet.txt\",\"size\":24,\"download_count\":0,\"created_at\":\"2026-04-26T12:59:29+02:00\",\"uuid\":\"251ef6f2-b2c4-4fc5-877e-cc4573bdd884\",\"browser_download_url\":\"https://codeberg.org/attachments/251ef6f2-b2c4-4fc5-877e-cc4573bdd884\"}}"
  }
]

3. List comment attachments

./forgejo-mcp --cli list_comment_attachments \
  --args '{"owner":"goern","repo":"forgejo-mcp","comment_id":13781165}'

[
  {
    "type": "text",
    "text": "{\"Result\":[{\"id\":1174940,\"name\":\"snippet.txt\",\"size\":24,...}]}"
  }
]

4. Get single-attachment metadata

./forgejo-mcp --cli get_comment_attachment \
  --args '{"owner":"goern","repo":"forgejo-mcp","comment_id":13781165,"attachment_id":1174940}'

5. Download

./forgejo-mcp --cli download_comment_attachment \
  --args '{"owner":"goern","repo":"forgejo-mcp","comment_id":13781165,"attachment_id":1174940}'

Same response shape as download_issue_attachment — a JSON text part and (if under cap) an EmbeddedResource with the base64 blob.

6. Rename

./forgejo-mcp --cli edit_comment_attachment \
  --args '{"owner":"goern","repo":"forgejo-mcp","comment_id":13781165,"attachment_id":1174940,"name":"renamed.txt"}'

7. Delete

./forgejo-mcp --cli delete_comment_attachment \
  --args '{"owner":"goern","repo":"forgejo-mcp","comment_id":13781165,"attachment_id":1174940}'

[
  {
    "type": "text",
    "text": "{\"Result\":{\"status\":\"deleted\"}}"
  }
]

Pattern: agent walks an issue with attachments scattered across comments

1. get_issue_by_index            → see issue body, comment count
2. list_issue_attachments        → see issue-level attachments
3. list_issue_comments           → enumerate comment IDs
4. for each comment_id:
     list_comment_attachments    → discover comment-level attachments
5. download_*_attachment         → pull bytes for any relevant file

This pattern lets an agent fully reconstruct an issue's attachment graph — the gap reported in #106.

3.5 KiB Raw Permalink Blame History