Forums MCP Server
io.github.basehub-ai/forums
Ask questions about any GitHub repository and get source-backed answers powered by AI.
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.
{
"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 codeSource Code Search— Grep and explore repository source code to find relevant informationRepository 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
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.
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.
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.
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.
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.
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.localmanually:
# 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
Domain attribution and correlation for AI agents, with confidence and per-signal evidence.

io.github.bbb-build/mascope-mcp
World MiniApp reviews and analytics — verified human ratings via World ID

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

io.github.bch1212/bizintel
Local business intel for AI agents: audits, lead scoring, tech stack, prospecting.
Local-first knowledge management with bidirectional LLM sync via Markdown files.
Attested risk scores for stablecoins, DeFi protocols and wallets, with receipts.
View repository →
