agentic-forges/forgejo-mcp
Watch
5
0
Fork
You've already forked forgejo-mcp
 0
Code Issues 9 Pull requests 6 Projects Releases 32 Packages 1 Activity

feat: add streamable HTTP transport support #101

Merged
goern merged 0 commits from refs/pull/101/head into main 2026-03-27 23:13:14 +00:00
Conversation 0 Commits - Files changed 345 +2673 -40781
goern commented 2026-03-27 23:07:27 +00:00 (Migrated from codeberg.org)
Copy link

Closes #99

Summary

  • Add --transport http using MCP spec 2025-03-26 streamable HTTP transport via mcp-go's server.NewStreamableHTTPServer
  • Add --http-port flag (default: 8080) for configuring the listen port
  • Update README with new transport docs and configuration table
  • Include openspec plan and showboat demo

Why

Streamable HTTP is the recommended MCP transport as of spec 2025-03-26. It is required for Claude.ai's custom MCP connector and replaces SSE on the deprecation path.

Changes

File Change
pkg/flag/flag.go Add HTTPPort variable
cmd/cmd.go Add --http-port flag, update help text
operation/operation.go Add case "http": transport handler
README.md Document new transport and flag
demos/streamable-http-transport.md Showboat demo
docs/plans/streamable-http-transport.md Openspec plan

Test plan

  • go build ./... passes
  • go test ./... passes
  • forgejo-mcp --transport http starts and accepts MCP connections
  • --transport stdio and --transport sse still work
  • --transport invalid errors with updated valid options

Time spent: 15min

Closes #99 ## Summary - Add `--transport http` using MCP spec `2025-03-26` streamable HTTP transport via `mcp-go`'s `server.NewStreamableHTTPServer` - Add `--http-port` flag (default: 8080) for configuring the listen port - Update README with new transport docs and configuration table - Include openspec plan and showboat demo ## Why Streamable HTTP is the recommended MCP transport as of spec `2025-03-26`. It is required for Claude.ai's custom MCP connector and replaces SSE on the deprecation path. ## Changes | File | Change | |------|--------| | `pkg/flag/flag.go` | Add `HTTPPort` variable | | `cmd/cmd.go` | Add `--http-port` flag, update help text | | `operation/operation.go` | Add `case "http":` transport handler | | `README.md` | Document new transport and flag | | `demos/streamable-http-transport.md` | Showboat demo | | `docs/plans/streamable-http-transport.md` | Openspec plan | ## Test plan - [x] `go build ./...` passes - [x] `go test ./...` passes - [ ] `forgejo-mcp --transport http` starts and accepts MCP connections - [ ] `--transport stdio` and `--transport sse` still work - [ ] `--transport invalid` errors with updated valid options Time spent: 15min
Sign in to join this conversation.
Reviewers
No reviewers
Labels
Clear labels   
Compat/Breaking
Breaking change that won't be backward compatible

  
Kind/Bug
Something is not working

  
Kind/Documentation
Documentation changes

  
Kind/Enhancement
Improve existing functionality

  
Kind/Feature
New functionality

  
Kind/OpenSpec
OpenSpec change proposal / spec-driven work

  
Kind/Security
This is security issue

  
Kind/Testing
Issue or pull request related to testing

  
Priority/Critical
The priority is critical

  
Priority/High
The priority is high

  
Priority/Low
The priority is low

  
Priority/Medium
The priority is medium

  
RFC - Request For Comments
Request For Comments — design/spec open for feedback before implementation

  
Reviewed/Confirmed
Issue has been confirmed

  
Reviewed/Duplicate
This issue or pull request already exists

  
Reviewed/Invalid
Invalid issue

  
Reviewed/Won't Fix
This issue won't be fixed

  
Status/Abandoned
Somebody has started to work on this but abandoned work

  
Status/Blocked
Something is blocking this issue or pull request

  
Status/Need More Info
Feedback is required to reproduce issue or to continue work

  
hermes-attempted
Hermes attempted but produced no changes

  
hermes-needs-clarification
Quality gate flagged, needs human input

  
hermes-ready
Ready for hermes to process

  
hermes-review
Hermes PR awaiting review

  
hermes-wip
Hermes is working on this

  
human-required
Hermes gave up after 3 attempts

No labels
Compat/Breaking
Kind/Bug
Kind/Documentation
Kind/Enhancement
Kind/Feature
Kind/OpenSpec
Kind/Security
Kind/Testing
Priority/Critical
Priority/High
Priority/Low
Priority/Medium
RFC - Request For Comments
Reviewed/Confirmed
Reviewed/Duplicate
Reviewed/Invalid
Reviewed/Won't Fix
Status/Abandoned
Status/Blocked
Status/Need More Info
hermes-attempted
hermes-needs-clarification
hermes-ready
hermes-review
hermes-wip
human-required
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
agentic-forges/forgejo-mcp!101
No description provided.