MCP Server

Active

GPL-3.0

Forums MCP Server

io.github.basehub-ai/forums

Ask questions about any GitHub repository and get source-backed answers powered by AI.

What is the Forums MCP server?

The Forums MCP server is an AI-powered Q&A tool for GitHub repositories that allows you to ask questions about any repo and receive answers grounded in the actual source code. It clones repositories, explores their structure, and uses grep to search the codebase, ensuring all answers are backed by the repository's source.

Forums enables AI agents to answer questions about GitHub repositories by automatically cloning them, analyzing their structure, and searching the source code. This is useful for developers who want to understand unfamiliar codebases, get quick answers about how code works, or have AI agents assist with repository exploration and documentation.

How to install Forums

Copy-paste configuration for popular MCP clients.

transport: http

Config generated by PluginBench — verify against the source before use.

~/.cursor/mcp.json

{
  "mcpServers": {
    "forums": {
      "url": "https://forums.basehub.com/mcp"
    }
  }
}

Tools & capabilities

Tools this server exposes to the agent.

Repository Q&A — Ask questions about any GitHub repository and receive answers grounded in the repository's source code
Source Code Search — Grep and explore repository source code to find relevant information
Repository Cloning — Automatically clone and analyze GitHub repositories

Use cases

Ask an AI agent to explain how a specific feature works in an open-source project
Get answers about API usage and function signatures by querying the source code directly
Understand the architecture and structure of an unfamiliar GitHub repository
Have AI agents help debug issues by searching relevant code sections
Generate documentation or summaries based on actual repository source code

Forums MCP server FAQ

What is the Forums MCP server?

Forums is an AI-powered Q&A system that lets you ask questions about any GitHub repository. It automatically clones the repo, searches the source code, and provides answers backed by the actual codebase.

Is Forums free to use?

The README does not specify pricing. The server is open-source and can be self-hosted, but the hosted version at forums.basehub.com may have its own terms.

How do I install Forums in Cursor or Claude?

Add the remote MCP server using the streamable-http endpoint: https://forums.basehub.com/mcp. Configuration details depend on your client; refer to your AI editor's MCP setup documentation.

What authentication is required?

Forums requires GitHub OAuth credentials (client ID and secret) to access repositories. A GitHub personal access token (PAT) is optional but recommended for higher API rate limits.

Can I self-host Forums?

Yes. You need to set up PostgreSQL, Typesense, create a GitHub OAuth app, and configure the required environment variables. Then build and run using Bun.

What repositories can I ask questions about?

You can ask questions about any public GitHub repository. The server will clone it, analyze the source code, and provide answers based on what it finds.

README (reference)

Source of truth, from the repository.

Forums

AI-powered Q&A for GitHub repositories. Ask questions about any repo and AI agents will clone, explore, and grep the source code to provide source-backed answers.

Contributing / Development

Prerequisites

Bun runtime
Vercel CLI (for pulling environment variables)
PostgreSQL database
Typesense instance

Setup

Clone the repository:

git clone https://github.com/basehub-ai/forums.git
cd forums

Install dependencies:

bun install

Set up environment variables. Either link to Vercel project or create .env.local manually:

# Option A: Pull from Vercel (requires access)
vc env pull .env.local

# Option B: Create manually with required variables (see Self-Hosting section)

Run database migrations:

bun run db:generate

Start the development server:

bun run dev

Scripts

Command	Description
`bun run dev`	Start development server
`bun run build`	Build for production
`bun run start`	Start production server
`bun run test`	Run tests
`bun run lint`	Lint and fix code
`bun run typecheck`	Type check
`bun run db:generate`	Generate database migrations

Self-Hosting

Environment Variables

Variable	Required	Description
`DATABASE_URL`	Yes	PostgreSQL connection string
`TYPESENSE_API_KEY`	Yes	Typesense API key
`TYPESENSE_HOST`	Yes	Typesense host URL
`GITHUB_CLIENT_ID`	Yes	GitHub OAuth app client ID
`GITHUB_CLIENT_SECRET`	Yes	GitHub OAuth app client secret
`GITHUB_TOKEN`	No	GitHub PAT for higher API rate limits
`REVALIDATE_SECRET`	No	Secret for cache revalidation webhook
`ADMIN_USER_EMAILS`	No	Comma-separated list of admin emails

Deploy to Vercel

Fork this repository
Import to Vercel
Configure environment variables
Deploy

Manual Deployment

Set up a PostgreSQL database
Set up a Typesense instance
Create a GitHub OAuth app
Configure all required environment variables
Build and run:

bun run build
bun run start

Related MCP servers

io.github.basicScandal/whoisgenius

Domain attribution and correlation for AI agents, with confidence and per-signal evidence.

io.github.basicmachines-co/basic-memory

Active

Local-first knowledge management with bidirectional LLM sync via Markdown files.

3.3k

Python

AGPL-3.0

View repository →

Basis Protocol

Attested risk scores for stablecoins, DeFi protocols and wallets, with receipts.

View repository →

io.github.batchwatch/batchwatch-mcp

Maintained

Ask batchwatch whether to batch a job and get the real measured queue evidence, not a guess.

C++

View repository →

io.github.batook22/project-knowledge-mcp

Active

Cross-project knowledge graph for MCP — map features across mobile, backend, and admin codebases.

TypeScript

MIT

View repository →

io.github.bats64mgutsi/nextrole-mcp-proxy

Maintained

MCP proxy server for NextRole CV tailoring services

JavaScript

MIT

View repository →