Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
claude mcp add --transport http forums 'https://forums.basehub.com/mcp'
{
"mcpServers": {
"forums": {
"type": "http",
"url": "https://forums.basehub.com/mcp"
}
}
}
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent 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
Questions fréquentes
Qu'est-ce que Forums ?
Ask any GitHub repository a question. Get source-backed answers.
Comment installer Forums ?
Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http forums 'https://forums.basehub.com/mcp'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour Forums ?
Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.
Forums est-il open source ?
Oui. Son code est sur GitHub sous licence GPL-3.0.
Qui maintient Forums ?
Il est publié par basehub-ai. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.