ai/gitea-mcp
1
0
Fork 0
mirror of https://gitea.com/gitea/gitea-mcp.git synced 2025-08-23 22:33:05 +00:00
Code Issues Packages Projects Releases Wiki Activity

Merge branch 'main' into add-sha-to-update-file

Browse Source
This commit is contained in:
hiifong
2025-03-25 04:29:07 +00:00
parent d48e233fba 28947a030e
commit 58328680a6
1 changed files with 11 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files

18
README.md
View File

@@ -2,11 +2,13 @@
**Gitea MCP Server** is an integration plugin designed to connect Gitea with Model Context Protocol (MCP) systems. This allows for seamless command execution and repository management through an MCP-compatible chat interface. **Gitea MCP Server** is an integration plugin designed to connect Gitea with Model Context Protocol (MCP) systems. This allows for seamless command execution and repository management through an MCP-compatible chat interface.
## 🚧 Installation ## 🚧Installation
There is currently no official release. You will need to build the Gitea MCP Server from source. ### 📥Download the official binary release
### 🔧 Build from Source You can download the official release from [here](https://gitea.com/gitea/gitea-mcp/releases).
### 🔧Build from Source
You can download the source code by cloning the repository using Git: You can download the source code by cloning the repository using Git:
@@ -25,7 +27,7 @@ Then run:
make build make build
``` ```
### 🛠️ Add to PATH ### 📁Add to PATH
After building, copy the binary gitea-mcp to a directory included in your system's PATH. For example: After building, copy the binary gitea-mcp to a directory included in your system's PATH. For example:
@@ -33,12 +35,13 @@ After building, copy the binary gitea-mcp to a directory included in your system
cp gitea-mcp /usr/local/bin/ cp gitea-mcp /usr/local/bin/
``` ```
## 🚀 Usage ## 🚀Usage
This example is for Cursor, you can also use plugins in VSCode. This example is for Cursor, you can also use plugins in VSCode.
To configure the MCP server for Gitea, add the following to your MCP configuration file: To configure the MCP server for Gitea, add the following to your MCP configuration file:
- **stdio mode** - **stdio mode**
```json ```json
{ {
"mcpServers": { "mcpServers": {
@@ -59,6 +62,7 @@ To configure the MCP server for Gitea, add the following to your MCP configurati
``` ```
- **sse mode** - **sse mode**
```json ```json
{ {
"mcpServers": { "mcpServers": {
@@ -109,10 +113,10 @@ The Gitea MCP Server supports the following tools:
|search_repos|Repository|Search for repositories| |search_repos|Repository|Search for repositories|
|get_gitea_mcp_server_version|Server|Get the version of the Gitea MCP Server| |get_gitea_mcp_server_version|Server|Get the version of the Gitea MCP Server|
## 🐛Debugging
## 🐛 Debugging
To enable debug mode, add the `-d` flag when running the Gitea MCP Server with sse mode: To enable debug mode, add the `-d` flag when running the Gitea MCP Server with sse mode:
```sh ```sh
./gitea-mcp -t sse --token <your personal access token> -d ./gitea-mcp -t sse --token <your personal access token> -d
``` ```