Forgejo MCP 服务器

<div style="position: relative; float: right;"> <img src="images/forgejo-mcp_small.png" alt="forgejo mcp server logo"/> </div>

这是一个模型上下文协议 (MCP) 服务器，它提供用于与 Forgejo REST API 交互的工具和资源， 例如托管在 https://codeberg.org/ 上的 API。

功能

• 列出和获取仓库
• 列出、获取和创建议题
• 获取用户信息
• 依赖注入，实现模块化架构
• 强大的错误处理和请求处理
• 缓存层，提高性能
• 全面的单元测试和集成测试
• 增强的 Forgejo 议题管理命令

安装

1. 克隆此仓库

2. 安装依赖项：

   npm install
   

3. 构建项目：

   npm run build
   

配置

要使用此 MCP 服务器，您需要：

1. 生成 Codeberg API 令牌：

   选项 1：使用辅助脚本：

   npm run get-token
   

   这将打开您的浏览器，转到 Codeberg 应用程序设置页面。

   选项 2：手动导航到：

   • 转到您的 Codeberg 设置：https://codeberg.org/user/settings/applications
   • 生成具有适当权限（repo，user）的新令牌
   • 复制令牌（它只会显示一次！）

2. 配置 API 令牌：

   选项 1：使用 .env 文件（推荐用于开发）：

   将 .env.sample 文件复制到项目根目录中的 .env，并添加您的令牌：

   cp .env.sample .env
   

   然后编辑 .env 文件以添加您的 Codeberg API 令牌：

   CODEBERG_API_TOKEN=your_token_here
   

   选项 2：使用 MCP 设置文件：

   对于 VSCode，编辑位于以下位置的 MCP 设置文件：

   • Windows: %APPDATA%\Code\User\globalStorage\rooveterinaryinc.roo-cline\settings\mcp_settings.json
   • macOS: ~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/mcp_settings.json
   • Linux: ~/.config/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/mcp_settings.json

   添加以下配置（示例文件位于 mcp-settings-sample.json）：

   {
     "mcpServers": {
       "codeberg": {
         "command": "node",
         "args": ["/absolute/path/to/mcp-codeberg/build/index.js"],
         "env": {
           "CODEBERG_API_TOKEN": "your-api-token-here"
         },
         "disabled": false,
         "alwaysAllow": []
       }
     }
   }
   

运行服务器

MCP 服务器可以在两种模式下运行：

Stdio 模式（默认）

这是 MCP 客户端（如 VSCode）使用的默认模式。

npm start
# 或
node build/index.js

HTTP 模式

您也可以在 HTTP 模式下运行服务器，该模式会启动一个 Web 服务器，提供有关 MCP 服务器的信息。

npm run start:http
# 或
node build/index.js --sse --port 3000 --host localhost

命令行选项：

• --sse: 启用 HTTP 模式 (默认: false)
• --port: HTTP 模式使用的端口 (默认: 3000)
• --host: HTTP 模式绑定的主机 (默认: localhost)
• --help: 显示帮助信息

示例：

# 在端口 8080 上以 HTTP 模式运行
node build/index.js --sse --port 8080

# 在 HTTP 模式下绑定到所有接口
node build/index.js --sse --host 0.0.0.0

# 显示帮助信息
node build/index.js --help

HTTP 服务器看起来像这样

可用工具

list_repositories

列出用户或组织的仓库。

参数：

• owner: 用户名或组织名称

示例：

{
  "owner": "username"
}

get_repository

获取有关特定仓库的详细信息。

参数：

• owner: 仓库所有者
• name: 仓库名称

示例：

{
  "owner": "username",
  "name": "repo-name"
}

list_issues

列出仓库的议题。

参数：

• owner: 仓库所有者
• repo: 仓库名称
• state: 议题状态（open，closed，all）- 可选，默认为“open”

示例：

{
  "owner": "username",
  "repo": "repo-name",
  "state": "open"
}

get_issue

获取有关特定议题的详细信息。

参数：

• owner: 仓库所有者
• repo: 仓库名称
• number: 议题编号

示例：

{
  "owner": "username",
  "repo": "repo-name",
  "number": 1
}

create_issue

在仓库中创建一个新议题。

参数：

• owner: 仓库所有者
• repo: 仓库名称
• title: 议题标题
• body: 议题正文

示例：

{
  "owner": "username",
  "repo": "repo-name",
  "title": "Bug: Something is not working",
  "body": "Detailed description of the issue"
}

get_user

获取有关用户的详细信息。

参数：

• username: 用户名

示例：

{
  "username": "username"
}

可用资源

当前用户个人资料

URI: codeberg://user/profile

仓库信息

URI 模板: codeberg://repos/{owner}/{repo}

仓库议题

URI 模板: codeberg://repos/{owner}/{repo}/issues

用户信息

URI 模板: codeberg://users/{username}

开发成本

直到提交 6ae7ebe1030d372646e38b59e4361d698ba16fc3 的成本为：

Tokens i/o: 3.4m/28.3k
Context Window: 85.9k of 200.0k
API Cost: $2.1752
Model: claude-3.7-sonnet via openrouter.ai

许可证

GPL-3.0-or-later