Forums

OfficialLive

by basehub-ai · TypeScript

Ask any GitHub repository a question. Get source-backed answers.

io.github.basehub-ai/forums MCP Server

This MCP server provides an AI-powered Q&A workflow for GitHub repositories. Users can ask questions about any GitHub repository, and the system uses source code cloning, exploration, and grep to produce source-backed answers.

🛠️ Key Features

Ask questions about any GitHub repository
Clone, explore, and grep source code for source-backed answers

🚀 Use Cases

Answer repository-specific questions using local source analysis
Support Q&A discussions tied to GitHub repository contents

⚡ Developer Benefits

Source-backed answers based on repository code inspection
Designed to operate with a Bun runtime, Vercel CLI, PostgreSQL, and Typesense

⚠️ Limitations

Requires a Bun runtime and supporting infrastructure (PostgreSQL and Typesense instance)
Setup depends on configuring environment variables (including via Vercel CLI)

README.md2 KBView 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:

bash

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

Install dependencies:

bash

bun install

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

bash

# 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:

bash

bun run db:generate

Start the development server:

bash

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:

bash

bun run build
bun run start

Install

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://forums.basehub.com/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "forums": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://forums.basehub.com/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

io.github.basehub-ai/forums MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Forums

Contributing / Development

Prerequisites

Setup

Scripts

Self-Hosting

Environment Variables

Deploy to Vercel

Manual Deployment

Install

Remote endpoint

Related servers