Repo Context Mcp

@pablo-peek

About Repo Context Mcp

Repo Context MCP provides programmatic access to repository contents for integrations and automation. It can list directories/files, read any file, return the README, perform TypeScript type analysis (via ts-morph), and search for OpenAPI/Swagger spec files. Supports local repo p

#server #openapi #typescript #ts-morph #analyzer #documentation #endpoints #repo #github

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "repo-context": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "@pablopeek/repo-context-mcp"
      ],
      "env": {
        "ENVIRONMENT": "local",
        "GITHUB_TOKEN": "<SET_GITHUB_TOKEN>",
        "GITHUB_NAME": "<SET_GITHUB_NAME>"
      }
    }
  }
}

Tools

Change the active repository path

List files and folders at the given path in the active repo

Read the content of a file in the active repo

Read the README.md file from the active repo

Analyze a file and return exported functions and the type of their parameters (if available)

Analyze a file using ts-morph and return exported functions and the type of their parameters (resolving local and imported types)

Read the content of a file from a (private) GitHub repository using the GitHub API.

Read the Swagger/OpenAPI specification file (swagger.json, openapi.json, openapi.yaml, etc.) from the active repo.

Overview

What is Repo Context MCP?

It is a programmatic MCP server to explore repositories, either local or from GitHub. It can list files, read file contents, return README, analyze TypeScript types using ts-morph, and locate OpenAPI/Swagger specs. It is intended for developers who want to programmatically interact with repository contents via an MCP interface.

How to use Repo Context MCP?

Set environment variables GITHUB_TOKEN and GITHUB_NAME (do not store tokens in config files). Then invoke the server and use its tools such as setRepoPath, getFiles, getFileContent, getReadme, analyzeFileTypes, analyzeFileTypesAdvanced, getGithubFileContent, and getSwaggerSpec.

Key features of Repo Context MCP

Set active repository path via setRepoPath
List files and folders with getFiles
Read file contents using getFileContent
Return root README.md with getReadme
Analyze TypeScript types with analyzeFileTypes (simple) and analyzeFileTypesAdvanced (ts-morph)
Fetch files from GitHub using getGithubFileContent (requires GITHUB_TOKEN)
Search for OpenAPI/Swagger specs with getSwaggerSpec

Use cases of Repo Context MCP

Programmatically explore a local codebase through MCP tools
Retrieve specific file contents from a GitHub repository without cloning
Analyze TypeScript type exports in a project
Locate and inspect OpenAPI/Swagger specification files in a repository

FAQ from Repo Context MCP

What environment variables are required?

GITHUB_TOKEN and GITHUB_NAME must be set. The token should never be stored in config files.

What repositories can Repo Context MCP access?

It can access both local file system repositories (via setRepoPath) and GitHub repositories (via getGithubFileContent using the token).

What tools does Repo Context MCP provide?

It provides setRepoPath, getFiles, getFileContent, getReadme, analyzeFileTypes, analyzeFileTypesAdvanced, getGithubFileContent, and getSwaggerSpec.

How does TypeScript analysis work?

analyzeFileTypes performs a simple exported function scan, while analyzeFileTypesAdvanced uses ts-morph resolution which may require project dependencies.

Can it find OpenAPI/Swagger specs?

Yes, getSwaggerSpec searches common locations for OpenAPI/Swagger specification files.

Frequently asked questions

What environment variables are required?

GITHUB_TOKEN and GITHUB_NAME must be set. The token should never be stored in config files.

What repositories can Repo Context MCP access?

It can access both local file system repositories (via setRepoPath) and GitHub repositories (via getGithubFileContent using the token).

What tools does Repo Context MCP provide?

It provides setRepoPath, getFiles, getFileContent, getReadme, analyzeFileTypes, analyzeFileTypesAdvanced, getGithubFileContent, and getSwaggerSpec.

How does TypeScript analysis work?

analyzeFileTypes performs a simple exported function scan, while analyzeFileTypesAdvanced uses ts-morph resolution which may require project dependencies.

Can it find OpenAPI/Swagger specs?

Yes, getSwaggerSpec searches common locations for OpenAPI/Swagger specification files.

Comments

Basic information

More Version Control MCP servers

MCP Git Ingest

adhikasp

A Model Context Protocol (MCP) server that helps read GitHub repository structure and important files.

316

Gerrit Review MCP Server

cayirtepeomer

This MCP server provides integration with Gerrit code review system, allowing AI assistants to review code changes and their details through a simple interface.

Gitlab Mcp Server

jmrplens

Open source GitLab MCP server for AI assistants: 2-tool dynamic find/execute over 860+ GitLab actions (1,000+ Enterprise), stdio/HTTP/OAuth, safe/read-only modes.

Bitbucket Server MCP

garc33

GitHub Actions 工作流使用说明

HenryHaoson

Yuque mcp server