2 Commits

Author SHA1 Message Date
08045538bf Add releases directory with documentation 2025-07-13 12:28:57 -05:00
b3nw
e3f7405cd8 feat: add network mode with combined HTTP and SSE endpoints
- Add new 'network' transport mode that serves both HTTP and SSE endpoints simultaneously
- HTTP endpoint available on specified port (/mcp)
- SSE endpoint available on port+1 (/sse)
- Maintain backward compatibility with stdio, http, sse modes
- Update documentation and examples for new network mode
- Default to network mode for improved user experience

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-07-13 17:26:12 +00:00
5 changed files with 88 additions and 23 deletions

View File

@@ -133,20 +133,16 @@ To configure the MCP server for Gitea, add the following to your MCP configurati
} }
``` ```
- **sse mode** - **network mode** (provides both HTTP and SSE endpoints)
```json Start the server in network mode:
{ ```bash
"mcpServers": { gitea-mcp -t network --host https://gitea.com --token <your-token> --port 8080
"gitea": {
"url": "http://localhost:8080/sse"
}
}
}
``` ```
- **http mode** Then configure your MCP client with either endpoint:
**HTTP endpoint:**
```json ```json
{ {
"mcpServers": { "mcpServers": {
@@ -157,6 +153,17 @@ To configure the MCP server for Gitea, add the following to your MCP configurati
} }
``` ```
**SSE endpoint:**
```json
{
"mcpServers": {
"gitea": {
"url": "http://localhost:8081/sse"
}
}
}
```
**Default log path**: `$HOME/.gitea-mcp/gitea-mcp.log` **Default log path**: `$HOME/.gitea-mcp/gitea-mcp.log`
> [!NOTE] > [!NOTE]

View File

@@ -20,14 +20,14 @@ func init() {
flag.StringVar( flag.StringVar(
&flagPkg.Mode, &flagPkg.Mode,
"t", "t",
"stdio", "network",
"Transport type (stdio, sse or http)", "Transport type (stdio, http, sse, or network). Network mode starts both HTTP and SSE servers",
) )
flag.StringVar( flag.StringVar(
&flagPkg.Mode, &flagPkg.Mode,
"transport", "transport",
"stdio", "network",
"Transport type (stdio, sse or http)", "Transport type (stdio, http, sse, or network). Network mode starts both HTTP and SSE servers",
) )
flag.StringVar( flag.StringVar(
&host, &host,
@@ -39,7 +39,7 @@ func init() {
&port, &port,
"port", "port",
8080, 8080,
"see or http port", "Network server port (used for both HTTP and SSE endpoints)",
) )
flag.StringVar( flag.StringVar(
&token, &token,

View File

@@ -1,6 +1,6 @@
{ {
"mcpServers": { "mcpServers": {
"gitea": { "gitea-stdio": {
"command": "gitea-mcp", "command": "gitea-mcp",
"args": { "args": {
"-t": "stdio", "-t": "stdio",
@@ -11,6 +11,12 @@
"GITEA_HOST": "https://gitea.com", "GITEA_HOST": "https://gitea.com",
"GITEA_ACCESS_TOKEN": "<your personal access token>" "GITEA_ACCESS_TOKEN": "<your personal access token>"
} }
},
"gitea-network-http": {
"url": "http://localhost:8080/mcp"
},
"gitea-network-sse": {
"url": "http://localhost:8081/sse"
} }
} }
} }

View File

@@ -42,25 +42,53 @@ func RegisterTool(s *server.MCPServer) {
func Run() error { func Run() error {
mcpServer = newMCPServer(flag.Version) mcpServer = newMCPServer(flag.Version)
RegisterTool(mcpServer) RegisterTool(mcpServer)
switch flag.Mode { switch flag.Mode {
case "stdio": case "stdio":
if err := server.ServeStdio(mcpServer); err != nil { if err := server.ServeStdio(mcpServer); err != nil {
return err return err
} }
case "sse":
sseServer := server.NewSSEServer(mcpServer)
log.Infof("Gitea MCP SSE server listening on :%d", flag.Port)
if err := sseServer.Start(fmt.Sprintf(":%d", flag.Port)); err != nil {
return err
}
case "http": case "http":
httpServer := server.NewStreamableHTTPServer(mcpServer) httpServer := server.NewStreamableHTTPServer(mcpServer)
log.Infof("Gitea MCP HTTP server listening on :%d", flag.Port) log.Infof("Gitea MCP HTTP server listening on :%d", flag.Port)
if err := httpServer.Start(fmt.Sprintf(":%d", flag.Port)); err != nil { if err := httpServer.Start(fmt.Sprintf(":%d", flag.Port)); err != nil {
return err return err
} }
case "sse":
sseServer := server.NewSSEServer(mcpServer)
log.Infof("Gitea MCP SSE server listening on :%d", flag.Port)
if err := sseServer.Start(fmt.Sprintf(":%d", flag.Port)); err != nil {
return err
}
case "network":
// Network mode: start both HTTP and SSE servers concurrently
log.Infof("Starting Gitea MCP server in network mode")
errChan := make(chan error, 2)
// Start HTTP server on port
go func() {
httpServer := server.NewStreamableHTTPServer(mcpServer)
log.Infof("Gitea MCP HTTP server listening on :%d", flag.Port)
if err := httpServer.Start(fmt.Sprintf(":%d", flag.Port)); err != nil {
errChan <- fmt.Errorf("HTTP server error: %w", err)
}
}()
// Start SSE server on port+1
go func() {
sseServer := server.NewSSEServer(mcpServer)
ssePort := flag.Port + 1
log.Infof("Gitea MCP SSE server listening on :%d", ssePort)
if err := sseServer.Start(fmt.Sprintf(":%d", ssePort)); err != nil {
errChan <- fmt.Errorf("SSE server error: %w", err)
}
}()
// Wait for first error
return <-errChan
default: default:
return fmt.Errorf("invalid transport type: %s. Must be 'stdio', 'sse' or 'http'", flag.Mode) return fmt.Errorf("invalid transport type: %s. Must be 'stdio', 'http', 'sse' or 'network'", flag.Mode)
} }
return nil return nil
} }

24
releases/README.md Normal file
View File

@@ -0,0 +1,24 @@
# Releases
## v0.5.0-combined - Network Mode
This directory contains binary releases for the combined server implementation.
### Features
- Network mode with both HTTP and SSE endpoints available simultaneously
- HTTP endpoint on specified port (/mcp)
- SSE endpoint on port+1 (/sse)
- Backward compatibility with stdio, http, sse modes
### Usage
```bash
# Download and make executable
chmod +x gitea-mcp-combined
# Start network mode
./gitea-mcp-combined -t network --host https://gitea.ext.ben.io --token <token> --port 8080
```
### Endpoints
- HTTP: http://localhost:8080/mcp
- SSE: http://localhost:8081/sse