GitLumen MCP

Official5 tools

by gitlumen-team · JavaScript

Screens public GitHub repos and PRs to generate risk maps, findings, and merge-readiness signals.

Gitlumen MCP Server (io.github.gitlumen-team/gitlumen-mcp)

This MCP server screens public GitHub repositories and pull requests to generate risk maps, findings, and merge-readiness signals. It is designed to process repository and PR data and output structured results (via its provided tools, 5 total) based on those inputs.

🛠️ Key Features

Screens public GitHub repos and pull requests
Generates risk maps
Produces findings
Computes merge-readiness signals
Exposes 5 tools

🚀 Use Cases

Assessing risk in public GitHub repositories and PRs
Reviewing PR status through merge-readiness signals
Producing findings alongside risk mapping for public code changes

⚡ Developer Benefits

Centralizes GitHub repo/PR screening outputs into risk maps, findings, and merge-readiness signals
Provides a fixed set of tools (5) for consuming the screening results

⚠️ Limitations

Limited to public GitHub repositories and pull requests

Captured live from the server via tools/list.

screen_repository

Screen a public GitHub repository or GitHub pull request URL and generate a GitLumen-style risk report. Supports repo URLs and /pull/<number> URLs.

Parameters5

repoUrl	string	required	GitHub repository URL, for example https://github.com/owner/repo or https://github.com/owner/repo/pull/123
branch	string	optional	Optional branch/ref. Ignored for PR URLs unless GitHub needs fallback.
scope	string	optional	Screening depth. quick downloads fewer files; standard downloads more files.
maxFiles	integer	optional	Optional hard cap for files downloaded and scanned.
output	string	optional	Response format returned to the MCP client.

Raw schema

{
  "type": "object",
  "properties": {
    "repoUrl": {
      "type": "string",
      "description": "GitHub repository URL, for example https://github.com/owner/repo or https://github.com/owner/repo/pull/123"
    },
    "branch": {
      "type": "string",
      "description": "Optional branch/ref. Ignored for PR URLs unless GitHub needs fallback."
    },
    "scope": {
      "type": "string",
      "enum": [
        "quick",
        "standard"
      ],
      "default": "standard",
      "description": "Screening depth. quick downloads fewer files; standard downloads more files."
    },
    "maxFiles": {
      "type": "integer",
      "minimum": 1,
      "maximum": 300,
      "description": "Optional hard cap for files downloaded and scanned."
    },
    "output": {
      "type": "string",
      "enum": [
        "compact",
        "markdown",
        "json"
      ],
      "default": "compact",
      "description": "Response format returned to the MCP client."
    }
  },
  "required": [
    "repoUrl"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_review_report

Get a previously generated GitLumen MCP report by reportId.

Parameters2

reportId	string	required	Report id returned by screen_repository, for example glr_abcd1234abcd1234
output	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "reportId": {
      "type": "string",
      "description": "Report id returned by screen_repository, for example glr_abcd1234abcd1234"
    },
    "output": {
      "type": "string",
      "enum": [
        "compact",
        "markdown",
        "json"
      ],
      "default": "compact"
    }
  },
  "required": [
    "reportId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_review_reports

List previously generated GitLumen MCP reports stored locally.

Parameters1

limit

integer

optional

Raw schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 20
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_repository_structure

Fetch public GitHub repository or PR structure without generating a full risk report.

Parameters3

repoUrl	string	required	GitHub repository or pull request URL.
branch	string	optional	Optional branch/ref.
limit	integer	optional	Maximum tree entries to return.

Raw schema

{
  "type": "object",
  "properties": {
    "repoUrl": {
      "type": "string",
      "description": "GitHub repository or pull request URL."
    },
    "branch": {
      "type": "string",
      "description": "Optional branch/ref."
    },
    "limit": {
      "type": "integer",
      "minimum": 10,
      "maximum": 1000,
      "default": 300,
      "description": "Maximum tree entries to return."
    }
  },
  "required": [
    "repoUrl"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

explain_gitlumen_mcp_flow

Explain how this Path 1 MCP server fits into GitLumen and how it later connects to Base MCP Path 2.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Install

Tools (5)

screen_repositoryget_review_reportlist_review_reportsget_repository_structureexplain_gitlumen_mcp_flow

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://mcp-github-screen.gitlumen.com/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "gitlumen-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp-github-screen.gitlumen.com/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

Gitlumen MCP Server (io.github.gitlumen-team/gitlumen-mcp)

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

screen_repository

get_review_report

list_review_reports

get_repository_structure

explain_gitlumen_mcp_flow

Install

Remote endpoint

Related servers