Sprint 01 Release: Gitea MCP Server v1.0.0 #8

lmiranda · 2026-02-03T20:34:56Z

lmiranda commented

2026-02-03 20:34:56 +00:00

Summary

Complete MCP server for Gitea API integration
Issue operations (list, get, create, update)
Label operations (list, create)
Milestone operations (list, create)
Comprehensive documentation
44 unit tests

Issues Closed

Closes #1, #2, #3, #4, #5, #6, #7

Test Plan

All 44 unit tests passing
Manual testing with Gitea API
Documentation reviewed

🤖 Generated with Claude Code

## Summary - Complete MCP server for Gitea API integration - Issue operations (list, get, create, update) - Label operations (list, create) - Milestone operations (list, create) - Comprehensive documentation - 44 unit tests ## Issues Closed Closes #1, #2, #3, #4, #5, #6, #7 ## Test Plan - [x] All 44 unit tests passing - [x] Manual testing with Gitea API - [x] Documentation reviewed 🤖 Generated with [Claude Code](https://claude.ai/code)

lmiranda added 10 commits 2026-02-03 20:34:56 +00:00

feat: implement MCP server core and authentication 1e0d896d87

Implemented MCP server core infrastructure with authentication and HTTP client:

- Created auth.py for API token management
  - Loads GITEA_API_URL and GITEA_API_TOKEN from environment
  - Uses python-dotenv for .env file support
  - Validates required configuration on initialization
  - Provides authentication headers for API requests

- Created client.py with base HTTP client
  - GiteaClient class using httpx AsyncClient
  - Async HTTP methods: get(), post(), patch(), delete()
  - Comprehensive error handling for HTTP status codes
  - Custom exception hierarchy for different error types
  - Configurable timeout (default 30s)

- Updated server.py with MCP server setup
  - Initialized MCP server with StdioServerTransport
  - Integrated AuthConfig and GiteaClient
  - Registered placeholder tool handlers (list_repositories, create_issue, create_pull_request)
  - Added CLI with --help and --version options
  - Proper error handling for configuration failures

- Updated pyproject.toml
  - Added console script entry point: gitea-mcp

- Created comprehensive unit tests
  - test_auth.py: Tests for AuthConfig validation and headers
  - test_client.py: Tests for GiteaClient initialization and error handling

All acceptance criteria met:
- MCP server initializes with StdioServerTransport
- Authentication loads from environment variables
- Base HTTP client with auth headers implemented
- Error handling for API connection failures
- Server reports available tools (placeholders for future issues)

Closes #2

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

feat(tools): implement issue operations - Closes #3 694406941c

Implement Gitea issue operations tools with the following features:
- gitea_list_issues: List issues with filters (state, labels, milestone)
- gitea_get_issue: Get single issue by number
- gitea_create_issue: Create new issue with title, body, labels, milestone
- gitea_update_issue: Update issue state, title, body, labels, assignees

Files added:
- src/gitea_mcp/tools/issues.py: Issue operation tool handlers

Files modified:
- src/gitea_mcp/server.py: Register issue tools in MCP server
- src/gitea_mcp/tools/__init__.py: Export issue tool functions

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

feat(tools): implement milestone operations 38dd315dd5

Implemented MCP tools for Gitea milestone operations:

- Created src/gitea_mcp/tools/milestones.py with milestone tools
  - gitea_list_milestones: List milestones with state filter (open/closed/all)
  - gitea_create_milestone: Create milestone with title, description, due date
  - Error handling via GiteaClientError
  - Helper functions _list_milestones and _create_milestone

- Updated src/gitea_mcp/tools/__init__.py
  - Exported get_milestone_tools and handle_milestone_tool

- Updated src/gitea_mcp/server.py
  - Imported milestone tool functions
  - Added milestone tools to list_tools()
  - Added milestone handler to call_tool() dispatcher

API endpoints implemented:
- GET /repos/{owner}/{repo}/milestones (list with state filter)
- POST /repos/{owner}/{repo}/milestones (create)

All acceptance criteria met:
- tools/milestones.py created with MCP tool handlers
- gitea_list_milestones with state filter implemented
- gitea_create_milestone with title, description, due_on implemented
- Tools registered in server.py
- tools/__init__.py exports updated

Closes #5

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

feat(tools): add label and milestone operations 7ffc0f9ce4

- Create labels.py with gitea_list_labels and gitea_create_label tools
- Integrate milestone tools from milestones.py into server
- Update tools/__init__.py with all tool exports
- Update server.py to handle label and milestone tool calls

Closes #4, Closes #5

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

docs: create comprehensive README ab8c9069da

Updated README.md with complete documentation including:
- Installation instructions from source and for development
- Configuration with environment variables and .env file setup
- MCP server setup for both Claude Desktop and Claude Code
- Detailed documentation of all 8 available tools with parameters and examples
- API reference for core components (GiteaClient, AuthConfig)
- Development setup and project structure
- Troubleshooting section for common issues

Closes #6

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

test: add comprehensive test suite - Closes #7 2230bceb51

Added comprehensive test coverage for all tool modules:

Test Files Created:
- tests/conftest.py: Shared fixtures for all tests
- tests/test_issues.py: Complete coverage for issue tools
- tests/test_labels.py: Complete coverage for label tools
- tests/test_milestones.py: Complete coverage for milestone tools

Test Coverage:
- Tool definition validation (schema structure)
- Handler function routing
- Successful API response formatting
- Error handling (GiteaClientError)
- Required parameter validation
- Optional parameter handling
- Mock Gitea API responses

Configuration Updates:
- Added pytest-cov>=4.0.0 to dev dependencies
- Created run_tests.sh script for easy test execution

All tests use pytest-asyncio for async functions and mock the
GiteaClient to avoid real API calls. Tests validate tool schemas,
handler routing, response formatting, and error handling.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Merge feat/2: Implement MCP server core and authentication 13ffd8a543

Merge feat/3-5: Implement issue, label, and milestone tools 0653a4f70e

Merge feat/6: Create comprehensive README and documentation 201cc680ca

Merge feat/7: Add comprehensive test suite b94dcebfc7

lmiranda merged commit 604661f096 into main

2026-02-03 20:42:06 +00:00

lmiranda referenced this issue from a commit

2026-02-03 20:42:06 +00:00

Merge pull request 'Sprint 01 Release: Gitea MCP Server v1.0.0' (#8) from development into main

lmiranda referenced this pull request

2026-02-03 22:50:57 +00:00

[Sprint 01] feat: Implement MCP Streamable HTTP protocol endpoints #24