Initial commit: Gitea MCP server with 62 tools

- Full Gitea REST API coverage for repos, issues, PRs, branches, files, releases, webhooks, orgs, notifications - Multi-instance support via config.json - pyproject.toml with pinned dependencies (mcp[cli], httpx) - config.example.json as credentials template (config.json is gitignored)
2026-06-02 08:31:39 +03:00
commit 781439bbdb
8 changed files with 889 additions and 0 deletions
@@ -0,0 +1,73 @@
+# gitea-platform-mcp
+
+Full Gitea platform management — 50 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:
+
+```json
+{
+  "instances": {
+    "default": {
+      "url": "https://your-gitea.example.com",
+      "token": "your_personal_access_token"
+    }
+  },
+  "default": "default"
+}
+```
+
+### Multiple Gitea instances
+
+```json
+{
+  "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
+
+- `uv` installed (https://docs.astral.sh/uv/)
+- Gitea instance accessible from your computer
+
+## Tools (50)
+
+| 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_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, compare_branches, list_repo_contributors |
+| Notifications | list_notifications, mark_all_notifications_read |