MCP Server

This NodeJS MCP server requires NodeJS 22.x or higher

Setup

$ npm install

Usage

To fire up the server

$ npx -y tsx server.ts

To debug or test, you can use the UI inspector:

$ npx @modelcontextprotocol/inspector

Tools

echo

Echoes any message passed to it.

login

Logs into a forgejo server and saves the token. You may use the server at https://forgejo.freshbrewed.science with the user testmcp.

get_user

Gets a user from a forgejo server. You must login first.

search_issues

Searches for issues in a repository. You must login first.

| Parameter | Type | Description | | --- | --- | --- | | owner | string | The owner of the repository | | repo | string | The name of the repository | | state | string | The state of the issues to search for (e.g., 'open', 'closed') | | labels | string | A comma-separated list of labels to search for | | milestones | string | A comma-separated list of milestones to search for | | q | string | A search query | | priority_repo_id | string | The ID of the repository to prioritize search results from | | type | string | The type of issue to search for (e.g., 'issues', 'pulls') | | since | string | A timestamp to search for issues created after | | before | string | A timestamp to search for issues created before | | assignees | string | A comma-separated list of assignees to search for | | assigned | boolean | Whether to search for assigned issues | | creator | string | The username of the creator to search for | | mentioned | string | The username of a user mentioned in the issue | | review_assignees | string | A comma-separated list of review assignees to search for | | reviewed | string | The username of a user who has reviewed the issue | | team | string | The name of the team to search for | | page | number | The page number of the search results | | limit | number | The number of search results to return per page |

list_issues

Lists issues for a repository. You must login first.

| Parameter | Type | Description | | --- | --- | --- | | owner | string | The owner of the repository | | repo | string | The name of the repository | | state | string | The state of the issues to list (e.g., 'open', 'closed') | | labels | string | A comma-separated list of labels to filter by | | milestones | string | A comma-separated list of milestones to filter by | | q | string | A search query to filter by | | priority_repo_id | string | The ID of the repository to prioritize results from | | type | string | The type of issue to list (e.g., 'issues', 'pulls') | | since | string | A timestamp to list issues created after | | before | string | A timestamp to list issues created before | | assignees | string | A comma-separated list of assignees to filter by | | assigned | boolean | Whether to list assigned issues | | creator | string | The username of the creator to filter by | | mentioned | string | The username of a user mentioned in the issue | | review_assignees | string | A comma-separated list of review assignees to filter by | | reviewed | string | The username of a user who has reviewed the issue | | team | string | The name of the team to filter by | | page | number | The page number of the results | | limit | number | The number of results to return per page |

create_issue

Creates an issue in a repository. You must login first.

| Parameter | Type | Description | | --- | --- | --- | | owner | string | The owner of the repository | | repo | string | The name of the repository | | title | string | The title of the issue | | assignee | string | The username of the assignee | | assignees | array | An array of usernames to assign to the issue | | body | string | The body of the issue | | closed | boolean | Whether the issue is closed | | due_date | string | The due date of the issue | | labels | array | An array of label IDs to assign to the issue | | milestone | number | The ID of the milestone to assign to the issue | | ref | string | The ref to create the issue from |