GitHub MCP Server

io.github.sumirati由 GitHub 账号 sumirati 发布v2.2.0更新于 Oct 31, 2026

Developer-ready GitHub MCP server with 5-tool hybrid architecture and dynamic discovery.

已验证STDIO仅桌面云端与基础设施开发者工具

概览

AI 生成的概览

本地运行的 MCP 服务器，通过 5 个工具和 83 个可发现操作，让助手调用 GitHub REST API 完成仓库、代码与协作任务。

可以做什么
  • 发现并执行 GitHub 操作：按领域检索操作，再执行 83 个操作之一，输入会经过校验。
  • 读取仓库与代码：仓库元数据、文件内容（含符号大纲与行范围）、分支、提交与差异。
  • 处理拉取请求与议题：列出、查看差异与评审、创建、更新、评论、合并，管理标签与里程碑。
  • 管理仓库设置：协作者与权限、Actions 变量与密钥元数据、Webhook、主题、Gist、发布与标签。
  • 查看 CI/CD 与安全：工作流、运行记录、任务日志、构建产物、提交状态与 Dependabot 告警。
适用场景
适合希望助手在对话中直接操作 GitHub 仓库的场景，例如审查拉取请求、阅读代码、整理议题、排查 CI 失败，或无需本地克隆就提交小改动。5 工具混合模式对只需偶尔访问 GitHub 的智能体更省上下文。
运行要求
以 npx 或全局 npm 安装方式在本地运行，需要 Node.js。需要 GitHub 个人访问令牌，放在 GITHUB_PERSONAL_ACCESS_TOKEN 中（也接受 GITHUB_TOKEN）。可选配置：GITHUB_API_URL（用于 GitHub Enterprise）、GITHUB_READ_ONLY、GITHUB_EXPOSE_ALL_TOOLS 和 MCP_OUTPUT_FORMAT。需要访问 GitHub API 的网络连接。
安装前请注意
令牌拥有其被授予的全部权限，且许多操作会写入 GitHub：创建和删除文件与分支、提交、合并拉取请求、发表评审与评论、添加或移除协作者、删除 Gist 和 Actions 变量。若不打算写入，请保持 GITHUB_READ_ONLY 开启，并使用仅限所需仓库的细粒度令牌。仓库数据会发送到 GITHUB_API_URL 所配置的 GitHub API 端点。

安装

在 SourceWeft 中

  1. 打开 控制台中的 GitHub MCP Server，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

GitHub MCP Server (@sumirati/mcp-github)

A modern, 2026 AI-native Model Context Protocol (MCP) server for GitHub REST API, engineered for autonomous AI agents and developer workflows.

[npm version] [License: MIT] [GitHub]

What makes v2 Unique: The 2026 5-Tool Hybrid Standard

In early MCP servers, exposing 50–100+ eager tool definitions flooded every LLM turn with thousands of redundant schema tokens ("System Prompt Tax") and degraded reasoning coherence.

@sumirati/mcp-github solves this with a 5-Tool Hybrid Surface:

  • Glama TDQS Coherence Tier A (5/5): By exposing exactly 5 tools to the client, the server sits in the ideal 3–15 tool coherence sweet spot.
  • Ultra-Lean System Prompt Tax: Drops schema overhead from 23,112 tokens (92,447 B) down to 1,125 tokens (4,498 B) (95.1% reduction), preserving context windows and maximizing LLM prompt-cache hits.
  • Zero-Hop Hourly Drivers: The 3 operations developers and agents use constantly (get_file_contents, get_repository, get_commit) remain eager tools for instant zero-hop execution.
  • 100% Platform Access on Demand: The entire platform surface of 83 actions across 13 domains is accessible on-demand via dynamic action discovery (github_find_actions $\rightarrow$ github_execute_action), delivering 91%–99% token savings with default high-density Markdown tables and summaries (format: "markdown" | "json").
  • Resilient Fallback: If an agent directly invokes any catalog action name (e.g. list_pull_requests), the server dynamically executes it with full input validation and projection.
text
LLM Prompt Context (5-Tool Hybrid Surface):├── 1. github_find_actions(query, [domain], [format])     [Meta Discovery]├── 2. github_execute_action(action, params, [format])   [Meta Dynamic Execution]├── 3. get_file_contents(owner, repo, path)               [Eager Daily Driver #1]├── 4. get_repository(owner, repo)                        [Eager Daily Driver #2]└── 5. get_commit(owner, repo, ref)                       [Eager Daily Driver #3]
Under the hood (Dynamic Registry):└── 83 Curated Actions across 13 Domains (grounded in GitHub REST API 2022-11-28)

Core Capabilities Across 13 Domains

  1. Repositories & Branch Governance (repositories, 12 actions): Full repository lifecycle, branch management, branch protection rules (get_branch_protection), file reading (auto Base64-decoded, symbol outlines, line slicing), single-file commits, and forks.
  2. Commits & Commit Statuses (commits, 6 actions): Commit history, token-capped commit diffs (get_commit), atomic multi-file commits via Git Trees API (create_commit, push_files), and commit status checks.
  3. Pull Requests & Code Reviews (pull-requests, 11 actions): PR lifecycle (create, update, merge), review comments, inline diff reviews, and unified diff inspection with lockfile filtering.
  4. Issues & Labels (issues, 8 actions): Issue tracking, upstream indexed filtering, conversation comments, and label management.
  5. Project Milestones (milestones, 4 actions): Milestone creation, progress tracking, and deadline management.
  6. Collaborators & Permissions (collaborators, 4 actions): Audit and manage repository collaborators and permission levels.
  7. Actions Variables & Secrets (variables, 6 actions): Manage repository Actions configuration variables and inspect secret metadata.
  8. Gists & Code Snippets (gists, 5 actions): Full gist lifecycle for sharing multi-file code snippets and configurations.
  9. GitHub Actions & CI/CD (actions, 10 actions): Workflow inspection, workflow runs, job step breakdown, build artifacts (list_workflow_run_artifacts, get_workflow_run_artifact), smart failure log extraction (get_job_logs), run cancel/rerun, and manual workflow dispatch.
  10. Releases & Git Tags (releases, 5 actions): Release publishing, lightweight/annotated tag creation, and release asset inspection.
  11. User, Organizations, Teams & Diagnostics (user, 7 actions): Authenticated user identity, organization inspection, team creation (create_team), accessible repositories, and API health/rate-limit diagnostics (system_health_check).
  12. Webhooks & Repository Topics (webhooks, 4 actions): Audit repository event webhooks and manage repository topic tags.
  13. Security & Dependabot (security, 1 action): Audit Dependabot vulnerability alerts by state and severity.

Quickstart & Installation

Option 1: Run with npx (No installation needed)

bash
npx -y @sumirati/mcp-github

Option 2: Install Globally

bash
npm install -g @sumirati/mcp-githubmcp-github

Option 3: Local Clone

bash
git clone https://github.com/sumirati/mcp-github.gitcd mcp-githubnpm installnpm testnpm start

Environment Configuration

VariableRequiredDefaultDescription
GITHUB_PERSONAL_ACCESS_TOKENYes—GitHub Personal Access Token (classic or fine-grained)
GITHUB_TOKENNo—Alternative token variable name
GITHUB_API_URLNohttps://api.github.comBase API URL (or GitHub Enterprise Server)
GITHUB_READ_ONLYNofalseEnable 3-tier read-only mode (true, 1, yes)
GITHUB_EXPOSE_ALL_TOOLSNofalseSet to true (or GITHUB_EXPOSE_LEGACY_TOOLS=true) to expose all 83 tools directly on ListTools for legacy clients
MCP_OUTPUT_FORMATNomarkdownDefault output format for tool execution (markdown or json)

Client Configuration

Google Antigravity / Claude Desktop / Cursor

Add to your MCP configuration file (mcp_config.json or claude_desktop_config.json):

Using npm / npx (Recommended):
json
{  "mcpServers": {    "github": {      "command": "npx",      "args": ["-y", "@sumirati/mcp-github"],      "env": {        "GITHUB_PERSONAL_ACCESS_TOKEN": "<your-github-token>",        "GITHUB_READ_ONLY": "false"      }    }  }}
Using local clone:
json
{  "mcpServers": {    "github": {      "command": "node",      "args": ["/path/to/mcp-github/index.js"],      "env": {        "GITHUB_PERSONAL_ACCESS_TOKEN": "<your-github-token>",        "GITHUB_READ_ONLY": "false"      }    }  }}

Complete Action Catalog Reference (83 Actions)

All 83 actions feature strict Zod input validation and 2-tier output projection:

1. The 5 Client-Exposed Tools (Hybrid Mode)

ToolTypeDescription
github_find_actionsMetaSearch and discover available GitHub operations across all 13 domains with compact parameter signatures
github_execute_actionMetaExecute any discovered GitHub platform action with input validation and token-optimized projection
get_file_contentsEagerRead raw file contents (auto Base64 decoded), symbol outlines, line ranges, or directory listings at any ref
get_repositoryEagerRetrieve repository metadata, visibility, description, default branch, HTML URL, and counts
get_commitEagerInspect Git commit details, author info, and token-capped file diffs

2. Repositories & Branches (repositories — 12 actions)

ActionDescriptionMutating?
search_repositoriesSearch for repositories across GitHub or within an organization using query qualifiers (e.g. 'org:myorg language:typescript') with capped pagination (max 100). If owner and repository name are known, prefer 'get_repository' for exact O(1) lookup.No
get_repositoryGet repository metadata, visibility, description, default branch, clone URL, and statistics for an exact owner/repo. Use when verifying repository settings or checking default branch name.No
create_repositoryCreate a new GitHub repository under the authenticated user account or a specified organization. Requires write permissions and GITHUB_READ_ONLY=false. Auto-initializes with a default README commit unless auto_init is false.Yes
get_file_contentsRead current file contents, extract symbol outlines ('outline_only: true'), slice line ranges, or list directory entries at a specified git ref. Automatically decodes Base64 into UTF-8. Use 'outline_only: true' first to inspect structure in ~50-100 tokens, then request specific line ranges.No
create_or_update_fileCreate a new file or overwrite an existing file on a branch in a single atomic commit. If updating, provide the file's current blob SHA in 'sha' (or leave empty to auto-resolve). Requires write permissions and GITHUB_READ_ONLY=false.Yes
delete_fileDelete an existing file from a branch in a git commit. Requires the current blob SHA to guard against concurrent overwrites. Requires write permissions and GITHUB_READ_ONLY=false.Yes
list_branchesList branches in a repository with protection status and head commit SHAs. Supports upstream filtering by protected status and capped pagination (max 100). If branch name is already known, prefer 'get_branch'.No
get_branchGet detailed status of a specific branch, including branch protection rules and latest commit details. Use to verify branch existence or protection policies before merging or deleting.No
get_branch_protectionRetrieve comprehensive branch protection rules for a specific Git branch, including required status checks, required reviews, admin enforcement, and force-push / deletion restrictions.No
create_branchCreate a new git branch pointing to a commit SHA or branched from an existing branch (defaults to 'main'). Use before committing changes or opening a pull request. Requires write permissions and GITHUB_READ_ONLY=false.Yes
delete_branchDelete a branch from a repository. Protected: explicitly rejects requests to delete the default branch (e.g. 'main') to prevent repository breakage. Requires write permissions and GITHUB_READ_ONLY=false.Yes
fork_repositoryFork a repository into the authenticated user's account or a specified organization namespace. Use when contributing to upstream projects where direct push access is restricted. Requires write permissions and GITHUB_READ_ONLY=false.Yes

3. Git Commits & Statuses (commits — 6 actions)

ActionDescriptionMutating?
list_commitsList repository commit history chronologically with upstream filtering (sha, path, author, since, until) and capped pagination (max 100). For viewing actual line-by-line diffs of a commit, use get_commit instead.No
get_commitGet detailed commit metadata, file modification statistics, and unified diffs for a specific commit SHA or ref. Use when reviewing code changes in a commit or debugging regressions. Diffs are token-budget optimized and truncated at max_diff_lines (default: 400 lines).No
create_commitCreate an atomic Git commit with multiple created, updated, or deleted files using the GitHub Git Trees API. Use when refactoring, applying multi-file code changes, or updating code and docs together. Avoids multiple individual single-file commits and does not require local git cloning. Requires write permissions and GITHUB_READ_ONLY=false.Yes
push_filesAlias for 'create_commit': atomically commit additions, modifications, or deletions to multiple files in a single Git commit via the GitHub Git Database API. Requires write permissions and GITHUB_READ_ONLY=false.Yes
get_commit_statusGet the combined status check state (pending, success, failure) and individual check runs for a commit SHA or branch ref.No
create_commit_statusSet or update a commit status check (pending, success, failure, error) on a specific commit SHA. Requires write permissions and GITHUB_READ_ONLY=false.Yes

4. Pull Requests & Code Reviews (pull-requests — 11 actions)

ActionDescriptionMutating?
list_pull_requestsList and filter pull requests with upstream indexed parameters (state, head, base) and capped pagination (max 100). To inspect a known PR, prefer 'get_pull_request' with pull_number; for diffs, use get_pull_request_diff.No
get_pull_requestGet detailed status of a specific pull request including mergeability (clean, dirty, unstable), head/base branch refs, author, and assignees. Use to check if a PR is ready to merge or blocked. Do NOT use to read code changes; use get_pull_request_diff instead.No
get_pull_request_diffRetrieve unified git diff for a pull request to review code modifications. Use this tool when analyzing code changes, reviewing patches, or preparing inline comments. Do NOT use for checking PR mergeability or metadata (use get_pull_request instead). Diffs are token-optimized and automatically truncated at max_lines (default: 400 lines) to prevent LLM context overflows.No
create_pull_requestCreate a new pull request from a head branch into a base branch. Requires write permissions and GITHUB_READ_ONLY=false. The head branch must already exist and have at least one commit difference from the base branch.Yes
update_pull_requestUpdate an existing pull request's title, body, open/closed state, or base branch. Requires write permissions and GITHUB_READ_ONLY=false.Yes
merge_pull_requestMerge a pull request into its base branch using merge, squash, or rebase method. Requires write/admin permissions and GITHUB_READ_ONLY=false. Ensure the PR mergeable state is clean before merging.Yes
list_pull_request_commentsList inline code review comments anchored to specific diff lines of a pull request. Use when inspecting line-by-line review feedback. For overall PR review approvals or change requests, use list_pull_request_reviews instead.No
create_pull_request_commentPost an inline review comment anchored to a specific file and line number in the pull request. Requires commit_id, path, and line number in the file. Requires write permissions and GITHUB_READ_ONLY=false.Yes
create_pull_request_replyReply to an existing pull request review comment thread. Requires comment_id of the parent comment. Requires write permissions and GITHUB_READ_ONLY=false.Yes
list_pull_request_reviewsList formal code reviews (approvals, change requests, comment summaries) submitted on a pull request. Use to check reviewer decisions and approval gates before merging.No
create_pull_request_reviewSubmit a formal code review on a pull request with an approval decision (APPROVE, REQUEST_CHANGES, or COMMENT) and optional summary body or inline comments. Requires write permissions and GITHUB_READ_ONLY=false.Yes

5. Issues & Labels (issues — 8 actions)

ActionDescriptionMutating?
list_issuesSearch and filter repository issue tickets with upstream indexed parameters (state, labels, assignee, creator, mentioned, milestone, since) and capped pagination (max 100). Filters out pull requests. If the issue number is already known, prefer 'get_issue' for exact O(1) lookup.No
get_issueGet full details of a specific issue ticket, including markdown body, assignees, milestone, state reason, and comment count. Use when investigating a bug report or reading issue specifications.No
create_issueCreate a new issue ticket in a repository with optional labels, assignees, and milestone. Requires write permissions and GITHUB_READ_ONLY=false.Yes
update_issueUpdate an existing issue's title, body, state ('open'/'closed'), state reason ('completed'/'not_planned'), labels, assignees, or milestone. Requires write permissions and GITHUB_READ_ONLY=false.Yes
list_issue_commentsList discussion comments on an issue ticket chronologically. Use to read conversation history, debugging updates, or user feedback on an issue.No
create_issue_commentAdd a markdown comment to an issue ticket. Use to reply to discussions, log progress, or provide resolution details. Requires write permissions and GITHUB_READ_ONLY=false.Yes
list_labelsList all labels configured in a repository with their names, descriptions, and hex color codes. Use to discover available tags before creating or updating issues.No
create_labelCreate a new label in a repository with a name, description, and 6-character hex color code. Requires write permissions and GITHUB_READ_ONLY=false.Yes

6. Project Milestones (milestones — 4 actions)

ActionDescriptionMutating?
list_milestonesList project milestones in a repository with open/closed issue counts and due dates. Use to monitor release roadmaps or locate milestone numbers before associating them with issues or PRs.No
get_milestoneGet detailed status of a specific milestone, including title, open/closed issues count, creation date, and deadline. Use when reviewing milestone progress or inspecting milestone deadlines.No
create_milestoneCreate a new project milestone with a title, description, and optional due date. Requires write permissions and GITHUB_READ_ONLY=false.Yes
update_milestoneUpdate an existing milestone's title, description, state ('open'/'closed'), or due date. Requires write permissions and GITHUB_READ_ONLY=false.Yes

7. Collaborators & Roles (collaborators — 4 actions)

ActionDescriptionMutating?
list_collaboratorsList collaborators who have access to a repository along with their assigned roles and permissions. Use to audit team access or check user memberships.No
get_collaborator_permissionCheck a specific user's exact permission level ('admin', 'maintain', 'write', 'triage', 'read', or 'none') on a repository. Use to verify authorization before attempting privileged operations.No
add_collaboratorAdd or invite a GitHub user to collaborate on a repository with a specified permission level. If the user is not an organization member, this sends a collaboration invitation. Requires admin permissions and GITHUB_READ_ONLY=false.Yes
remove_collaboratorRemove a collaborator from a repository, revoking their direct access. Requires admin permissions and GITHUB_READ_ONLY=false.Yes

8. Actions Variables & Secrets (variables — 6 actions)

ActionDescriptionMutating?
list_actions_variablesList non-sensitive GitHub Actions configuration variables defined on a repository with their values and timestamps. Use for inspecting build environment parameters.No
get_actions_variableGet the plain text value and last updated timestamp of a specific GitHub Actions repository variable by name.No
create_actions_variableCreate a non-sensitive configuration variable for GitHub Actions workflows. Requires write/admin permissions and GITHUB_READ_ONLY=false. For sensitive credentials, use repository secrets instead.Yes
update_actions_variableUpdate the value of an existing non-sensitive GitHub Actions configuration variable. Requires write/admin permissions and GITHUB_READ_ONLY=false.Yes
delete_actions_variableDelete a non-sensitive configuration variable from GitHub Actions. Requires write/admin permissions and GITHUB_READ_ONLY=false.Yes
list_actions_secretsList GitHub Actions repository secret names and timestamps. Behavioral safety: secret values are permanently masked by GitHub and never returned in plaintext.No

9. Gists & Code Snippets (gists — 5 actions)

ActionDescriptionMutating?
list_gistsList code snippets and gists owned by the authenticated user with file summaries. Use to locate code snippet IDs before reading or editing.No
get_gistGet full source code contents, files, and description of a specific GitHub gist by ID. Use to inspect standalone code snippets or configuration templates.No
create_gistCreate a new public or secret GitHub gist with one or more files. Requires write permissions and GITHUB_READ_ONLY=false.Yes
update_gistUpdate an existing gist's description or modify/rename/delete individual files within the gist. Requires write permissions and GITHUB_READ_ONLY=false.Yes
delete_gistPermanently delete a gist by its identifier. Requires write permissions and GITHUB_READ_ONLY=false.Yes

10. GitHub Actions & CI/CD Observability (actions — 10 actions)

ActionDescriptionMutating?
list_workflowsList GitHub Actions CI/CD workflow files configured in a repository (.github/workflows). Use to discover workflow names and IDs before triggering or inspecting runs.No
list_workflow_run_artifactsList artifacts produced by a specific GitHub Actions workflow run, including file size, download archive URLs, and expiration timestamps. Use to discover generated build outputs, test logs, or release binaries.No
get_workflow_run_artifactRetrieve metadata and download archive URL for a specific GitHub Actions build artifact by its numeric artifact ID. Use when downloading build deliverables or inspecting individual artifacts.No
list_workflow_runsList workflow execution runs with status, conclusion ('success', 'failure'), triggering event, and commit SHA. Use to check CI/CD pipeline health or find run IDs.No
get_workflow_runGet detailed status, timing, and conclusion for a specific workflow execution run. Use when monitoring CI pipeline completion.No
list_workflow_run_jobsList all individual jobs and step breakdown within a workflow run. Use to identify which specific job or step failed during a build.No
get_job_logsFetch plain text execution logs for an Actions job with smart failure extraction and ANSI stripping. Behavioral safety: scans for errors/panics to extract failure blocks and trims massive logs to preserve LLM token context.No
trigger_workflowDispatch a workflow run on a branch or tag via workflow_dispatch event with custom inputs. Requires write permissions and GITHUB_READ_ONLY=false. The target workflow file must define a workflow_dispatch trigger.Yes
cancel_workflow_runCancel a queued or currently executing GitHub Actions workflow run. Requires write permissions and GITHUB_READ_ONLY=false.Yes
rerun_workflowRe-execute all jobs in a completed or failed GitHub Actions workflow run. Requires write permissions and GITHUB_READ_ONLY=false.Yes

11. Releases & Git Tags (releases — 5 actions)

ActionDescriptionMutating?
list_releasesList published and draft releases in a repository with release titles, asset download counts, and published dates. Use to check release history or download URLs.No
get_releaseGet full details of a specific release by tag name or numeric release ID, including changelog body and asset links.No
create_releasePublish a formal GitHub release for a tag, with title, markdown release notes/changelog, and pre-release/draft flags. Requires write permissions and GITHUB_READ_ONLY=false.Yes
list_tagsList git tags in a repository with tag names and commit SHAs. Use to inspect available version tags before publishing a release.No
create_tagCreate a git tag (lightweight reference or annotated tag object when message is provided) pointing to a specific commit SHA. Requires write permissions and GITHUB_READ_ONLY=false.Yes

12. User, Organizations & Teams (user — 7 actions)

ActionDescriptionMutating?
system_health_checkPerform end-to-end connectivity, latency, rate limit quota, and permission diagnostics against the GitHub API. Verifies token validity, authenticated account details, remaining rate limits, and active read-only policy.No
get_authenticated_userRetrieve profile metadata (login, name, email, public_repos, followers) for the currently authenticated GitHub token. Use to verify token identity and scope.No
get_userRetrieve public profile information (login, name, company, bio, public_repos count) for any specified GitHub user by username.No
list_user_organizationsList GitHub organizations that the authenticated user belongs to. Use to discover org namespaces for creating or querying repositories.No
get_organizationRetrieve comprehensive details for a specific GitHub organization (name, description, email, blog, public/private repos). Use when verifying organization access or inspecting org settings.No
create_teamCreate a new team in a GitHub organization. Supports parent_team_id to establish nested child teams. Requires organization owner/admin privileges and GITHUB_READ_ONLY=false.Yes
list_accessible_repositoriesList repositories accessible to the authenticated user (owned, collaborated on, or member of). Use to discover available repositories across accounts.No

13. Webhooks & Topics (webhooks — 4 actions)

ActionDescriptionMutating?
get_repository_topicsGet all topic tags associated with a GitHub repository. Use to inspect project categories and discoverability keywords.No
set_repository_topicsReplace all topic tags on a repository with a new array of topic strings. Requires write permissions and GITHUB_READ_ONLY=false.Yes
list_repository_webhooksList configured event webhooks on a repository with target URLs, active status, and subscribed event triggers.No
get_repository_webhookGet detailed configuration of a specific repository webhook by ID, including delivery URL and subscribed events.No

14. Security & Dependabot (security — 1 action)

ActionDescriptionMutating?
list_dependabot_alertsList Dependabot vulnerability alerts for a repository, including affected package, severity (critical, high, medium, low), and patch advisory.No

Benchmarks: Reproducible Token Economy Proof (test/benchmark-test.js)

Grounded strictly in official GitHub REST API (2022-11-28) response schemas (test/fixtures/github-api-v3-fixtures.js) and verified on every npm test run via node test/benchmark-test.js:

OperationRaw GitHub API (2022-11-28)Projected JSON (format: "json")Default Markdown (format: "markdown")Verified Reduction
System Prompt Tax (83 tools vs 5 hybrid tools)23,112 tokens (92,447 B)—1,125 tokens (4,498 B)95.1% savings
get_repository (1 repository)1,321 tokens (5,283 B)104 tokens (414 B)85 tokens (340 B)93.6% savings
list_issues (10 issues)15,375 tokens (61,499 B)1,567 tokens (6,267 B)313 tokens (1,250 B)98.0% savings
list_pull_requests (10 PRs with head/base repo)46,536 tokens (186,141 B)1,586 tokens (6,341 B)330 tokens (1,317 B)99.3% savings
list_workflow_runs (10 workflow runs)14,957 tokens (59,826 B)839 tokens (3,356 B)212 tokens (846 B)98.6% savings
get_file_contents (outline_only: true)3,589 tokens (14,355 B)331 tokens (1,323 B)314 tokens (1,255 B)91.3% savings

How Token Compression Works

  • System Prompt Tax Reduction (95.1% savings): Shrinks MCP ListTools schema footprint from 83 full tool schemas (23,112 tokens / 92,447 B) down to the 5-tool hybrid surface (1,125 tokens / 4,498 B).
  • Recursive Output Projection Filter (projectOutput): Automatically strips GitHub REST API v3 hypermedia template URLs (*_url RFC 6570 templates), avatar_url, gravatar_id, node_id, site_admin, _links, internal api.github.com self-links, and null/"" fields.
  • Smart Diff & Lockfile Truncation: Commit and PR diffs automatically collapse dependency lockfiles (package-lock.json, pnpm-lock.yaml, yarn.lock, go.sum, Cargo.lock, *.min.js) via ignore_lockfiles: true by default. Pass ignore_lockfiles: false to inspect full lockfile diffs.
  • Conservative Default Pagination: All list actions default to per_page: 10 (max: 100).
  • Default High-Density Markdown Format: Discovery (github_find_actions), execution (github_execute_action), and all 3 eager tools default to format: "markdown".
  • Unified Diff Truncation: PR (max_lines) and commit (max_diff_lines) diffs default to 400 lines.
  • Safe Log Tailing: CI workflow job logs extract the failure block and teardown tail (tail_lines, default: 100) with ANSI escape sequence stripping.

Roadmap

Completed in v2.1

  • Upstream indexed filtering & strict pagination caps (state, labels, assignee, creator, mentioned, milestone, since)
  • Client error resilience (Secondary rate limit / abuse detection, 403/404 scope diagnostics, empty-body 201/202 handling)
  • Hardened output projection with recursion depth guard (maxDepth = 32), RFC 6570 hypermedia URL stripping, and empty collection preservation
  • Nested child team & organization management (create_team, get_organization)
  • Smart CI/CD failure log extraction & ANSI sequence stripping in get_job_logs (strip_ansi, smart_failure)
  • Outline-first code symbol extraction & line range slicing in get_file_contents (outline_only, start_line, end_line)
  • Atomic multi-file commits (create_commit, push_files) supporting file creation, updates, and deletions via GitHub Git Trees API
  • Pre-flight mergeability & conflict verification (get_mergeability)
  • Token scope self-auditing & permission pre-flight

Future Horizons (v2.x)

  • Standardized collection _summary headers to facilitate multi-turn history pruning in LiteLLM / Eigent agent orchestration
  • Remote Transports: Streamable SSE and HTTP remote server modes
  • Scoped GraphQL query engine for relational deep inspections
  • DevSecOps code scanning & secret scanning alert queries
  • Scoped & rate-guarded code search within project repositories

Acknowledgements & Lineage

This project incorporates architectural concepts, schemas, and patterns from:

See NOTICE for complete third-party attribution details.

License

This project is licensed under the MIT License — Copyright (c) 2026 [email protected].

来源：README.md，提交 ce7318f

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

4
  1. v2.2.0最新Oct 17, 2026
  2. v2.1.0Oct 16, 2026
  3. v1.3.1Oct 15, 2026
  4. v1.0.0Oct 15, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分