Forums MCP Server

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

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

Self-Hosting

Environment Variables

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