Skip to content

HUMANS.md

Latest commit

 

History

History
55 lines (32 loc) · 2.88 KB

HUMANS.md

File metadata and controls

55 lines (32 loc) · 2.88 KB

@rethunk/github-mcp — User guide

Rollup GitHub tools for LLMs via MCP. How the server is installed and wired to clients: docs/install.md only (do not restate that material here).

Badges

CI GitHub release Node.js

Implementation map (modules under src/server/, entry src/server.ts), symbols, and contract bumps live in AGENTS.md at the repository root.

Registered tool ids, parameters, JSON shapes, error codes: docs/mcp-tools.md — canonical; not duplicated here.

Authentication

All tools require a GitHub token. The server resolves it in order:

  1. GITHUB_TOKEN environment variable
  2. GH_TOKEN environment variable
  3. gh auth token subprocess (if gh CLI is installed)

Set the token in your MCP client's env block — see docs/install.md.

Required scopes: repo (for private repository access), read:org (for org_pulse).

GitHub Enterprise: set GITHUB_API_URL (defaults to https://api.github.com) and optionally GITHUB_GRAPHQL_URL in the env block.

Installation

Package install and MCP clients: docs/install.md.

Development

See CONTRIBUTING.md for dev setup, build commands, git hooks, commit conventions, CI, and how to add a tool.

Publishing

GitHub (automated) — version tags only

Tag pushes run .github/workflows/release.yml: build, check, tests, then:

  1. npm pack using the committed package.json name @rethunk/github-mcp — tarball attached to a GitHub Release for that tag.
  2. GitHub Packages (npm registry): workflow temporarily rewrites name to @rethunk-ai/github-mcp (required scope for org Rethunk-AI) and runs npm publish to https://npm.pkg.github.com with GITHUB_TOKEN.

Prerequisite: push a semver git tag vX.Y.Z that exactly matches version in package.json.

npmjs (manual) — maintainers only

  1. On a clean checkout at the release commit, run bun run prepublishOnly.
  2. Log in: npm login so npm whoami shows the account that owns @rethunk on npmjs.
  3. Ensure package.json has "name": "@rethunk/github-mcp" and publishConfig.access is "public".
  4. Publish: npm publish --access public.

package.json files must keep the whole dist/ directory so every emitted chunk is packed.