OctoCounts MCP Server

Official

by huanglizhuo · JavaScript

Analyze and compare public GitHub repo line counts (SLOC) via OctoCounts, from any MCP client.

Analyze and compare public GitHub repository line counts (SLOC) using OctoCounts from an MCP client. The server exposes OctoCounts SLOC reports to AI coding tools such as Claude and Cursor, and any MCP client.

🛠️ Key Features

Provides an analyze_repo tool to count files, lines, code, comments, blanks, and languages for a public GitHub repo
Provides a compare_repos tool to compare two public GitHub repos or refs

🚀 Use Cases

Generate code metrics (SLOC breakdown) for a public GitHub repository
Compare SLOC and related counts between two public repositories or refs

⚡ Developer Benefits

Works with any MCP client (including Claude and Cursor)
Uses a single MCP server package published under io.github.huanglizhuo/octocounts-mcp

⚠️ Limitations

Operates on public GitHub repos only (as indicated by the tool descriptions)

Topics

chrome-extensionslocbrowser-extensioncode-metricsdeveloper-toolsgithub-extensionsrusttokei

mcp/README.md1 KBView on GitHub

OctoCounts MCP Server

Expose OctoCounts SLOC reports to AI coding tools (Claude, Cursor, and any MCP client).

Tools:

analyze_repo: count files, lines, code, comments, blanks, and languages for a public GitHub repo.
compare_repos: compare two public GitHub repos or refs.

Usage

Run via npx (no install needed):

json

{
  "mcpServers": {
    "octocounts": {
      "command": "npx",
      "args": ["-y", "octocounts-mcp"]
    }
  }
}

Or from a local checkout:

json

{
  "mcpServers": {
    "octocounts": {
      "command": "node",
      "args": ["/absolute/path/to/OctoCounts/mcp/src/index.js"],
      "env": {
        "OCTOCOUNTS_API_BASE": "https://api.octocounts.com"
      }
    }
  }
}

OCTOCOUNTS_API_BASE defaults to https://api.octocounts.com.

Local protocol smoke test:

bash

node mcp/src/index.js

The server speaks MCP over stdio with Content-Length framed JSON-RPC messages.

License

MIT

Install

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "octocounts-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "octocounts-mcp@0.1.1"
      ]
    }
  }
}

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

OctoCounts MCP Server

Usage

License

Install

Related servers