a-limasov-ii
a6162a855c
- pytest + respx + pytest-cov added as dev dependencies - tests/smoke/test_registration.py: verify all 66 tools registered and unique - tests/unit/: 12 files covering every tool — HTTP method, URL, params/body, errors - tests/config.test.json + conftest.py: zero-network test setup via GITEA_CONFIG - CLAUDE.md: developer guide with testing philosophy, pyramid, and commands - server/gitea_mcp.py: get_commit, list_pr_files tools added - README.md: tool count corrected to 66
gitea-platform-mcp
Full Gitea platform management — 66 tools for repositories, issues, PRs, branches, files, releases, webhooks, and organizations.
Setup (one-time)
1. Edit config.json
Open config.json in the plugin folder and fill in your Gitea details:
{
"instances": {
"default": {
"url": "https://your-gitea.example.com",
"token": "your_personal_access_token"
}
},
"default": "default"
}
Multiple Gitea instances
{
"instances": {
"home": {
"url": "https://gitea.home.example.com",
"token": "token_for_home"
},
"work": {
"url": "https://gitea.work.example.com",
"token": "token_for_work"
}
},
"default": "home"
}
Then in chat: "покажи репозитории на work" — Claude передаст instance="work" в инструмент.
2. Create a Gitea token
Gitea → Settings → Applications → Personal Access Tokens
Recommended permissions: repo, issue, notification, user, organization
3. Verify connection
After installing, ask: "проверь подключение к Gitea" — Claude вызовет get_current_user и get_server_info.
Requirements
uvinstalled (https://docs.astral.sh/uv/)- Gitea instance accessible from your computer
Tools (66)
| Category | Tools |
|---|---|
| Meta | list_instances, get_server_info, get_current_user |
| Repositories | list_my_repos, search_repos, get_repo, create_repo, create_org_repo, update_repo, delete_repo, fork_repo, set_repo_topics |
| Branches & Tags | list_branches, get_branch, create_branch, delete_branch, list_tags |
| Files | list_directory, get_file, create_file, update_file, delete_file |
| Issues | list_issues, get_issue, create_issue, update_issue, close_issue, reopen_issue, list_issue_comments, add_issue_comment, edit_issue_comment, delete_issue_comment |
| Labels & Milestones | list_labels, create_label, add_issue_labels, list_milestones, create_milestone |
| Pull Requests | list_pull_requests, get_pull_request, create_pull_request, update_pull_request, merge_pull_request, get_pr_diff, list_pr_files, list_pr_reviews, create_pr_review |
| Releases | list_releases, get_latest_release, create_release, delete_release |
| Webhooks | list_repo_webhooks, create_repo_webhook, delete_repo_webhook |
| Users & Orgs | get_user, search_users, list_my_orgs, get_org, list_org_repos, list_org_members, list_org_teams |
| Commits | list_commits, get_commit, compare_branches, list_repo_contributors |
| Notifications | list_notifications, mark_all_notifications_read |