Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
claude mcp add --transport http forums 'https://forums.basehub.com/mcp'
{
"mcpServers": {
"forums": {
"type": "http",
"url": "https://forums.basehub.com/mcp"
}
}
}
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
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
Frequently asked questions
What is Forums?
Ask any GitHub repository a question. Get source-backed answers.
How do I install Forums?
It runs as a remote server. In Claude Code: claude mcp add --transport http forums 'https://forums.basehub.com/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.
Does Forums need an API key?
Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.
Is Forums open source?
Yes. Its code is on GitHub under the GPL-3.0 license.
Who maintains Forums?
It is published by basehub-ai. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.