@ric_/forgejo-mcp 0.1.4 → 0.1.5

package/README.md

@@ -137,6 +137,12 @@ The Docker image:
 - Read-only filesystem
 - No new privileges security option
 
+## Auto Setup
+
+When an MCP client (such as Claude Code, Claude Desktop, or Cursor) connects to this server, it automatically receives instructions describing all available tool categories and usage conventions. This means the AI assistant understands how to use the server without any additional prompting — it knows which tools exist, that most require `owner` and `repo` parameters, how pagination works, and that file content should be base64-encoded.
+
+No configuration is needed to enable this; it works out of the box via the MCP `initialize` handshake.
+
 ## Available Tools
 
 ### Repository Management (24 tools)

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAQjD,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,SAAS,CAuB7D"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AA4BjD,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,SAAS,CAwB7D"}

package/dist/server.js

@@ -6,6 +6,25 @@ import { registerPullRequestTools } from "./tools/pullrequests.js";
 import { registerOrganizationTools } from "./tools/organizations.js";
 import { registerUserTools } from "./tools/users.js";
 import { registerAdminTools } from "./tools/admin.js";
+const SERVER_INSTRUCTIONS = `This MCP server connects to a Forgejo (or Gitea) instance and provides tools to interact with its API.
+
+## Tool categories
+
+- **Repository**: search_repos, get_repo, create_repo, create_org_repo, delete_repo, fork_repo, edit_repo, transfer_repo, list_branches, get_branch, create_branch, delete_branch, list_repo_commits, get_file_contents, create_file, update_file, delete_file, list_releases, create_release, list_tags, list_repo_topics, update_repo_topics, list_forks, list_collaborators, add_collaborator
+- **Issues**: list_issues, get_issue, create_issue, edit_issue, list_issue_comments, create_issue_comment, edit_issue_comment, delete_issue_comment, list_labels, get_label, create_label, edit_label, delete_label, add_issue_labels, remove_issue_label, list_milestones, get_milestone, create_milestone, edit_milestone, delete_milestone
+- **Pull Requests**: list_pull_requests, get_pull_request, create_pull_request, edit_pull_request, merge_pull_request, list_pr_commits, list_pr_files, get_pr_diff, list_pr_reviews, create_pr_review, request_pr_review, update_pr_branch
+- **Organizations**: list_orgs, get_org, create_org, edit_org, delete_org, list_org_repos, list_org_members, list_org_teams, get_team, create_team, add_team_member, remove_team_member, list_org_labels, list_org_hooks
+- **Users**: get_authenticated_user, get_user, list_user_repos, list_user_orgs, search_users, list_followers, list_following, list_user_starred, list_my_starred, star_repo, unstar_repo, list_my_notifications, mark_notifications_read
+- **Admin**: admin_list_users, admin_create_user, admin_delete_user, admin_edit_user, admin_list_cron_jobs, admin_run_cron_job, admin_list_hooks, get_server_version, render_markdown, render_markup, list_gitignore_templates, get_gitignore_template, list_license_templates, get_license_template, list_label_templates, get_label_template, get_nodeinfo, list_action_runners_jobs, get_runner_registration_token
+
+## Conventions
+
+- Most tools require \`owner\` and \`repo\` parameters to identify a repository.
+- List endpoints support pagination with \`page\` (starting at 1) and \`limit\` (1–50) parameters.
+- Tool names use snake_case with a domain prefix for admin tools (e.g. \`admin_list_users\`).
+- File content parameters (create_file, update_file) expect base64-encoded content.
+- The server returns JSON responses from the Forgejo API, or error messages with HTTP status codes on failure.
+`;
 export function createServer(config) {
     const server = new McpServer({
         name: "forgejo-mcp",
@@ -14,6 +33,7 @@ export function createServer(config) {
         capabilities: {
             logging: {},
         },
+        instructions: SERVER_INSTRUCTIONS,
     });
     const client = new ForgejoClient(config);
     registerRepositoryTools(server, client);

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD,MAAM,UAAU,YAAY,CAAC,MAAqB;IAChD,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B;QACE,IAAI,EAAE,aAAa;QACnB,OAAO,EAAE,OAAO;KACjB,EACD;QACE,YAAY,EAAE;YACZ,OAAO,EAAE,EAAE;SACZ;KACF,CACF,CAAC;IAEF,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;IAEzC,uBAAuB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,wBAAwB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,yBAAyB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEnC,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;CAkB3B,CAAC;AAEF,MAAM,UAAU,YAAY,CAAC,MAAqB;IAChD,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B;QACE,IAAI,EAAE,aAAa;QACnB,OAAO,EAAE,OAAO;KACjB,EACD;QACE,YAAY,EAAE;YACZ,OAAO,EAAE,EAAE;SACZ;QACD,YAAY,EAAE,mBAAmB;KAClC,CACF,CAAC;IAEF,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;IAEzC,uBAAuB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,wBAAwB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,yBAAyB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEnC,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ric_/forgejo-mcp",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "A Model Context Protocol (MCP) server for Forgejo and Gitea instances. Provides 103 tools across repos, issues, PRs, orgs, users, and admin APIs. Works with Claude, Cursor, and any MCP-compatible client. Supports stdio and HTTP transports. Built with Claude Code.",
   "type": "module",
   "license": "MIT",