PluginBench
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.

RepositoryRegistry
How to choose

What this kind of tool is for

  • Let your agent search the web or a document set and cite what it found.
  • Pull structured facts out of pages instead of copy-pasting by hand.
  • Track changes on a topic over days without re-reading everything.

How to compare servers like this

Source coverage:
Check which engines, sites, or document types the tool can actually reach.
Citation behavior:
Prefer tools that return links you can open, not just summarized claims.
Terms of service:
Some sources forbid automated access; make sure the tool stays inside them.
Maintenance signal:
Scrapers break silently when pages change; recent commits are the best proxy.

This page carries your copy-paste config: pick your MCP client in the install section on this page and use the copy button.

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
JSON config
{
  "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

Setup

  1. Clone the repository:
git clone https://github.com/basehub-ai/forums.git
cd forums
  1. Install dependencies:
bun install
  1. 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)
  1. Run database migrations:
bun run db:generate
  1. Start the development server:
bun run dev

Scripts

CommandDescription
bun run devStart development server
bun run buildBuild for production
bun run startStart production server
bun run testRun tests
bun run lintLint and fix code
bun run typecheckType check
bun run db:generateGenerate database migrations

Self-Hosting

Environment Variables

VariableRequiredDescription
DATABASE_URLYesPostgreSQL connection string
TYPESENSE_API_KEYYesTypesense API key
TYPESENSE_HOSTYesTypesense host URL
GITHUB_CLIENT_IDYesGitHub OAuth app client ID
GITHUB_CLIENT_SECRETYesGitHub OAuth app client secret
GITHUB_TOKENNoGitHub PAT for higher API rate limits
REVALIDATE_SECRETNoSecret for cache revalidation webhook
ADMIN_USER_EMAILSNoComma-separated list of admin emails

Deploy to Vercel

  1. Fork this repository
  2. Import to Vercel
  3. Configure environment variables
  4. Deploy

Manual Deployment

  1. Set up a PostgreSQL database
  2. Set up a Typesense instance
  3. Create a GitHub OAuth app
  4. Configure all required environment variables
  5. Build and run:
bun run build
bun run start

Related MCP servers

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

World MiniApp reviews and analytics — verified human ratings via World ID

0
JavaScript
View repository →

Token-budgeted web fetch for AI agents — auto-routes Jina, FireCrawl, Trafilatura, PDF.

0
Python
MIT
View repository →

Local business intel for AI agents: audits, lead scoring, tech stack, prospecting.

0
Python
MIT
View repository →

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

3.3k
Python
AGPL-3.0
View repository →

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

View repository →