# MCP LangChainJS Server

[![CI](https://github.com/PlumyCat/mcp-github-langchain-js/actions/workflows/ci.yml/badge.svg)](https://github.com/PlumyCat/mcp-github-langchain-js/actions/workflows/ci.yml)

Serveur MCP (Model Context Protocol) en TypeScript permettant de rechercher des exemples et du code dans le dépôt GitHub LangChainJS (`langchain-ai/langchainjs`). Il expose un outil `search_langchain` que les clients MCP (ex. Claude Desktop) peuvent appeler pour retrouver rapidement des snippets TS/JS/MD pertinents.

## Aperçu
- Outil principal: `search_langchain`
- Source: GitHub Search Code API via `@octokit/rest`
- Transport: `stdio` (pour intégration avec clients MCP)
- Langage: TypeScript (build vers `dist/`)

## Prérequis
- Node.js 18+ et npm
- (Optionnel) Un jeton GitHub personnel pour des quotas plus généreux
  - Variable d’environnement: `GITHUB_TOKEN`

## Installation
```bash
npm install
npm run build
```

## Démarrage
- Développement (TypeScript, sans build):
```bash
npm run dev
```
- Watch (redémarrage auto):
```bash
npm run watch
```
- Production (depuis `dist/`):
```bash
npm start
```

Le serveur écoute via `stdio` et est destiné à être lancé par un client MCP.

## Configuration du client MCP (ex. Claude Desktop)
Exemple de configuration Claude Desktop (à adapter à votre chemin local) :
```json
{
  "mcpServers": {
    "langchain-js": {
      "command": "node",
      "args": [
        "/chemin/vers/votre/projet/dist/index.js"
      ],
      "env": {
        "GITHUB_TOKEN": "votre_token_optionnel"
      }
    }
  }
}
```

Notes:
- `GITHUB_TOKEN` est recommandé pour éviter les limitations strictes de l’API publique.
- Ne commitez jamais de secrets. Préférez des variables d’environnement ou un fichier `.env` ignoré par Git.

## Variables d’environnement
Vous pouvez fournir un jeton GitHub pour augmenter les limites d’API :
```bash
export GITHUB_TOKEN=ghp_xxx_votre_token
```
Ou via un fichier `.env` (non commité) si votre outil de lancement le supporte.

## Outils exposés
- `search_langchain`
  - Entrée:
    - `query` (string, requis): la requête de recherche (TS/JS/MD)
  - Sortie (texte): liste des correspondances avec nom, chemin, et URL HTML

Exemple d’appel (côté client MCP):
```json
{
  "name": "search_langchain",
  "arguments": { "query": "RetrievalQA" }
}
```

## Architecture
- `src/index.ts`: serveur MCP + transport `stdio`, enregistrement des handlers
- `src/tools/search.ts`: schéma de l’outil et handler `search_langchain`
- `src/github-client.ts`: client GitHub (Octokit) pour recherche et lecture de contenu
- `src/types.ts`: types internes (exemples, résultats)

## Scripts npm
- `npm run dev`: exécute `src/index.ts` avec `ts-node`
- `npm run watch`: redémarre avec `nodemon` sur changements
- `npm run build`: compile TypeScript vers `dist/`
- `npm start`: lance `node dist/index.js`

## Dépannage
- Erreurs 403/abuse/ratelimit: fournissez `GITHUB_TOKEN`.
- Résultats vides: vérifiez la requête (`query`) et les extensions ciblées (TS/JS/MD).
- Import/ESM: le projet est configuré en `type: commonjs` avec `ts-node` adapté; utilisez `npm run build` puis `npm start` en prod.

## Sécurité
- Ne mettez jamais un jeton en clair dans le dépôt.
- Préférez des variables d’environnement et des gestionnaires de secrets.

## Licence
ISC