This commit is contained in:
yp05327
2025-03-25 02:56:56 +00:00
parent 7845a84c4e
commit 6f86512a7d

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,12 +113,12 @@ 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 ./path/to/gitea-mcp -t sse --token <your personal access token> -d
``` ```
Enjoy exploring and managing your Gitea repositories via chat! Enjoy exploring and managing your Gitea repositories via chat!