npm - langchain-mcp - Versions diffs - 1.0.0 - Mend

langchain-mcp 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (12) hide show

package/README.md ADDED Viewed

@@ -0,0 +1,56 @@
+# langchain-mcp
+MCP server for searching LangChain, LangGraph & LangSmith documentation and source code.
+## Installation
+```bash
+npm i -g langchain-mcp
+langchain-mcp login
+claude mcp add langchain-mcp -- npx langchain-mcp
+```
+## Claude Desktop
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
+```json
+{
+  "mcpServers": {
+    "langchain-mcp": {
+      "command": "npx",
+      "args": ["langchain-mcp"]
+    }
+  }
+}
+```
+## CLI Commands
+```bash
+langchain-mcp login    # Login with GitHub/Google
+langchain-mcp status   # Check login status and usage
+langchain-mcp logout   # Logout
+```
+## MCP Tools
+| Tool | Description |
+|------|-------------|
+| `search_langchain_docs` | Search documentation |
+| `search_langchain_code` | Search source code |
+| `search_langchain` | Hybrid search (docs + code) |
+## Free Credits
+New users get **$5 free credits** (~150 searches).
+## Links
+- Website: https://langchain-mcp.xyz
+- GitHub: https://github.com/baixianger/langchain-mcp
+- Sponsor: https://github.com/sponsors/baixianger
+## License
+MIT

package/dist/bin/cli.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ #!/usr/bin/env node
2	+ export {};

package/dist/bin/cli.js ADDED Viewed

@@ -0,0 +1,186 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import http from 'http';
+import open from 'open';
+import { loadConfig, saveConfig, deleteConfig, getConfigPath, DEFAULT_API_URL } from '../src/config.js';
+import { APIClient } from '../src/api-client.js';
+const program = new Command();
+program
+    .name('langchain-mcp')
+    .description('CLI for LangChain MCP server')
+    .version('1.0.0');
+/**
+ * Login command - supports Google and GitHub OAuth
+ */
+program
+    .command('login')
+    .description('Login to LangChain MCP service')
+    .option('--provider <provider>', 'OAuth provider: google or github', 'google')
+    .option('--no-browser', 'Print URL instead of opening browser')
+    .option('--api-url <url>', 'API server URL', DEFAULT_API_URL)
+    .action(async (options) => {
+    const existingConfig = loadConfig();
+    if (existingConfig) {
+        console.log('Already logged in.');
+        console.log('Run "langchain-mcp logout" first to log out.');
+        return;
+    }
+    const provider = options.provider.toLowerCase();
+    if (provider !== 'google' && provider !== 'github') {
+        console.error('Invalid provider. Use --provider google or --provider github');
+        process.exit(1);
+    }
+    await loginWithWebFlow(options.apiUrl, provider, options.browser);
+});
+/**
+ * Web Flow login - opens browser for OAuth
+ */
+async function loginWithWebFlow(apiUrl, provider, openBrowser) {
+    const port = 9876;
+    const callbackUrl = `http://localhost:${port}/callback`;
+    const server = http.createServer(async (req, res) => {
+        const url = new URL(req.url, `http://localhost:${port}`);
+        if (url.pathname === '/callback') {
+            const apiKey = url.searchParams.get('api_key');
+            const userJson = url.searchParams.get('user');
+            const error = url.searchParams.get('error');
+            if (error) {
+                res.writeHead(400, { 'Content-Type': 'text/html; charset=utf-8' });
+                res.end(`
+          <!DOCTYPE html>
+          <html>
+          <head><title>Login Failed</title></head>
+          <body style="font-family: system-ui; text-align: center; padding: 50px;">
+            <h1>❌ Login Failed</h1>
+            <p>${error}</p>
+          </body>
+          </html>
+        `);
+                console.error(`\nLogin failed: ${error}`);
+                server.close();
+                process.exit(1);
+            }
+            if (apiKey && userJson) {
+                try {
+                    const user = JSON.parse(userJson);
+                    // Save config
+                    saveConfig({
+                        api_key: apiKey,
+                        api_url: apiUrl,
+                        user,
+                    });
+                    console.log(`\n✅ Logged in as ${user.email}`);
+                    console.log(`💰 Credits: $${user.credits.toFixed(2)} remaining`);
+                    console.log(`📁 Config saved to ${getConfigPath()}`);
+                    res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
+                    res.end(`
+            <!DOCTYPE html>
+            <html>
+            <head><title>Login Successful</title></head>
+            <body style="font-family: system-ui; text-align: center; padding: 50px;">
+              <h1>✅ Login Successful!</h1>
+              <p>Welcome, ${user.name || user.email}!</p>
+              <p>You can close this window and return to your terminal.</p>
+            </body>
+            </html>
+          `);
+                    setTimeout(() => {
+                        server.close();
+                        process.exit(0);
+                    }, 1000);
+                }
+                catch (err) {
+                    res.writeHead(400);
+                    res.end('Login failed: invalid response');
+                    server.close();
+                    process.exit(1);
+                }
+            }
+            else {
+                res.writeHead(400, { 'Content-Type': 'text/html; charset=utf-8' });
+                res.end(`
+          <!DOCTYPE html>
+          <html>
+          <head><title>Login Failed</title></head>
+          <body style="font-family: system-ui; text-align: center; padding: 50px;">
+            <h1>❌ Login Failed</h1>
+            <p>Missing API key</p>
+          </body>
+          </html>
+        `);
+                server.close();
+                process.exit(1);
+            }
+        }
+        else {
+            res.writeHead(404);
+            res.end('Not found');
+        }
+    });
+    server.listen(port, () => {
+        // OAuth URL via our API
+        const authUrl = `${apiUrl}/auth/${provider}?callback=${encodeURIComponent(callbackUrl)}`;
+        const providerName = provider === 'google' ? 'Google' : 'GitHub';
+        console.log(`🔐 Logging in with ${providerName}...`);
+        if (openBrowser) {
+            console.log('Opening browser for login...');
+            open(authUrl);
+        }
+        else {
+            console.log('Open this URL in your browser:');
+            console.log(authUrl);
+        }
+        console.log(`\nWaiting for login callback on port ${port}...`);
+    });
+    // Timeout after 5 minutes
+    setTimeout(() => {
+        console.log('\n⏰ Login timeout. Please try again.');
+        server.close();
+        process.exit(1);
+    }, 5 * 60 * 1000);
+}
+/**
+ * Status command - show current login status and usage
+ */
+program
+    .command('status')
+    .description('Show current login status and usage')
+    .action(async () => {
+    const config = loadConfig();
+    if (!config) {
+        console.log('❌ Not logged in.');
+        console.log('Run "langchain-mcp login" to log in.');
+        return;
+    }
+    console.log(`👤 Logged in as: ${config.user?.email || 'Unknown'}`);
+    console.log(`📁 Config: ${getConfigPath()}`);
+    try {
+        const client = new APIClient(config.api_url, config.api_key);
+        const usage = await client.getUsage();
+        console.log(`\n💰 Credits: $${usage.credits.remaining.toFixed(2)} remaining`);
+        console.log(`\n📊 Usage:`);
+        console.log(`  Today: ${usage.usage.today.tokens.toLocaleString()} tokens (${usage.usage.today.requests} requests)`);
+        console.log(`  This month: ${usage.usage.this_month.tokens.toLocaleString()} tokens (${usage.usage.this_month.requests} requests)`);
+        console.log(`  All time: ${usage.usage.all_time.tokens.toLocaleString()} tokens (${usage.usage.all_time.requests} requests)`);
+    }
+    catch (error) {
+        console.log(`\n⚠️  Could not fetch usage: ${error.message}`);
+        console.log('Your API key may be invalid. Run "langchain-mcp login" to log in again.');
+    }
+});
+/**
+ * Logout command - remove local credentials
+ */
+program
+    .command('logout')
+    .description('Logout and remove local credentials')
+    .action(async () => {
+    const config = loadConfig();
+    if (!config) {
+        console.log('Not logged in.');
+        return;
+    }
+    deleteConfig();
+    console.log('✅ Logged out successfully.');
+});
+program.parse();

package/dist/src/api-client.d.ts ADDED Viewed

@@ -0,0 +1,73 @@
+export interface SearchResult {
+    id: string;
+    content: string;
+    metadata: {
+        filePath: string;
+        language?: string;
+        product?: string;
+        topic?: string;
+        codeType?: string;
+    };
+    distance: number;
+    repo: string;
+}
+export interface SearchResponse {
+    results: SearchResult[];
+    usage: {
+        tokens_used: number;
+        credits_remaining: number;
+    };
+}
+export interface UsageResponse {
+    clerk_id: string;
+    credits: {
+        remaining_cents: number;
+        remaining: number;
+    };
+    usage: {
+        today: {
+            tokens: number;
+            requests: number;
+        };
+        this_month: {
+            tokens: number;
+            requests: number;
+        };
+        all_time: {
+            tokens: number;
+            requests: number;
+        };
+    };
+}
+export interface APIError {
+    error: {
+        code: string;
+        message: string;
+    };
+}
+export declare class APIClient {
+    private baseUrl;
+    private sessionToken;
+    constructor(baseUrl: string, sessionToken: string);
+    private request;
+    searchDocs(input: {
+        query: string;
+        limit?: number;
+        product?: string;
+        language?: string;
+    }): Promise<SearchResponse>;
+    searchCode(input: {
+        query: string;
+        limit?: number;
+        product?: string;
+        language?: string;
+        code_type?: string;
+    }): Promise<SearchResponse>;
+    searchHybrid(input: {
+        query: string;
+        limit?: number;
+        include_docs?: boolean;
+        include_code?: boolean;
+    }): Promise<SearchResponse>;
+    getUsage(): Promise<UsageResponse>;
+}

package/dist/src/api-client.js ADDED Viewed

@@ -0,0 +1,42 @@
+export class APIClient {
+    baseUrl;
+    sessionToken;
+    constructor(baseUrl, sessionToken) {
+        this.baseUrl = baseUrl;
+        this.sessionToken = sessionToken;
+    }
+    async request(method, endpoint, body) {
+        const response = await fetch(`${this.baseUrl}${endpoint}`, {
+            method,
+            headers: {
+                'Authorization': `Bearer ${this.sessionToken}`,
+                'Content-Type': 'application/json',
+            },
+            body: body ? JSON.stringify(body) : undefined,
+        });
+        const data = await response.json();
+        if (!response.ok) {
+            const error = data;
+            if (error.error?.code === 'INSUFFICIENT_CREDITS') {
+                throw new Error('Insufficient credits. Visit https://langchain-mcp.xyz to add more credits.');
+            }
+            if (error.error?.code === 'UNAUTHORIZED') {
+                throw new Error('Session expired. Run: langchain-mcp login');
+            }
+            throw new Error(error.error?.message || `API error: ${response.status}`);
+        }
+        return data;
+    }
+    async searchDocs(input) {
+        return this.request('POST', '/search/docs', input);
+    }
+    async searchCode(input) {
+        return this.request('POST', '/search/code', input);
+    }
+    async searchHybrid(input) {
+        return this.request('POST', '/search/hybrid', input);
+    }
+    async getUsage() {
+        return this.request('GET', '/usage');
+    }
+}

package/dist/src/config.d.ts ADDED Viewed

@@ -0,0 +1,15 @@
+export interface UserConfig {
+    api_key: string;
+    api_url: string;
+    user?: {
+        id: string;
+        email: string;
+        name: string | null;
+        credits: number;
+    };
+}
+export declare const DEFAULT_API_URL: string;
+export declare function loadConfig(): UserConfig | null;
+export declare function saveConfig(config: UserConfig): void;
+export declare function deleteConfig(): void;
+export declare function getConfigPath(): string;

package/dist/src/config.js ADDED Viewed

@@ -0,0 +1,30 @@
+import { readFileSync, writeFileSync, mkdirSync, existsSync, unlinkSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+const CONFIG_DIR = join(homedir(), '.config', 'langchain-mcp');
+const CONFIG_FILE = join(CONFIG_DIR, 'config.json');
+export const DEFAULT_API_URL = process.env.LANGCHAIN_MCP_API_URL || 'https://api.langchain-mcp.xyz';
+export function loadConfig() {
+    try {
+        if (!existsSync(CONFIG_FILE)) {
+            return null;
+        }
+        const content = readFileSync(CONFIG_FILE, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+export function saveConfig(config) {
+    mkdirSync(CONFIG_DIR, { recursive: true });
+    writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2));
+}
+export function deleteConfig() {
+    if (existsSync(CONFIG_FILE)) {
+        unlinkSync(CONFIG_FILE);
+    }
+}
+export function getConfigPath() {
+    return CONFIG_FILE;
+}

package/dist/src/index.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ #!/usr/bin/env node
2	+ export {};

package/dist/src/index.js ADDED Viewed

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { createServer } from './server.js';
+async function main() {
+    const server = createServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('LangChain MCP server running on stdio');
+}
+main().catch((error) => {
+    console.error('Failed to start server:', error);
+    process.exit(1);
+});

package/dist/src/server.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
2	+ export declare function createServer(): McpServer;

package/dist/src/server.js ADDED Viewed

@@ -0,0 +1,155 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+import { loadConfig } from './config.js';
+import { APIClient } from './api-client.js';
+// Schemas
+const searchDocsSchema = z.object({
+    query: z.string().describe('Search query'),
+    limit: z.number().int().min(1).max(20).default(5).describe('Max results (1-20)'),
+    product: z.enum(['langsmith', 'langchain', 'langgraph', 'deepagents', 'oss']).optional().describe('Filter by product'),
+    language: z.enum(['python', 'javascript']).optional().describe('Filter by language'),
+});
+const searchCodeSchema = z.object({
+    query: z.string().describe('Search query'),
+    limit: z.number().int().min(1).max(20).default(5).describe('Max results (1-20)'),
+    product: z.enum(['langchain', 'langgraph', 'deepagents']).optional().describe('Filter by product'),
+    language: z.enum(['python', 'javascript']).optional().describe('Filter by language'),
+    code_type: z.enum(['function', 'class', 'module']).optional().describe('Filter by code type'),
+});
+const searchHybridSchema = z.object({
+    query: z.string().describe('Search query'),
+    limit: z.number().int().min(1).max(20).default(10).describe('Max results (1-20)'),
+    include_docs: z.boolean().default(true).describe('Include documentation'),
+    include_code: z.boolean().default(true).describe('Include source code'),
+});
+function formatDocsResults(results) {
+    if (results.length === 0) {
+        return 'No results found.';
+    }
+    return results.map((r, i) => {
+        const meta = r.metadata;
+        const header = `## ${i + 1}. ${meta.filePath}`;
+        const info = [
+            meta.product && `Product: ${meta.product}`,
+            meta.language && `Language: ${meta.language}`,
+            meta.topic && `Topic: ${meta.topic}`,
+        ].filter(Boolean).join(' | ');
+        const content = r.content.length > 1500 ? r.content.slice(0, 1500) + '...' : r.content;
+        return `${header}\n${info}\n\n${content}`;
+    }).join('\n\n---\n\n');
+}
+function formatCodeResults(results) {
+    if (results.length === 0) {
+        return 'No results found.';
+    }
+    return results.map((r, i) => {
+        const meta = r.metadata;
+        const lang = meta.language === 'python' ? 'python' : 'typescript';
+        const header = `## ${i + 1}. ${meta.filePath}`;
+        const info = [
+            meta.codeType && `Type: ${meta.codeType}`,
+            meta.product && `Product: ${meta.product}`,
+        ].filter(Boolean).join(' | ');
+        const content = r.content.length > 2000 ? r.content.slice(0, 2000) + '...' : r.content;
+        return `${header}\n${info}\n\n\`\`\`${lang}\n${content}\n\`\`\``;
+    }).join('\n\n---\n\n');
+}
+const LOGIN_MESSAGE = `## Not logged in
+Please login first by running this command in your terminal:
+\`\`\`bash
+langchain-mcp login
+\`\`\`
+This will open a browser for GitHub/Google authentication.
+After logging in, restart Claude to use the LangChain MCP tools.
+For more info: https://langchain-mcp.xyz`;
+export function createServer() {
+    const config = loadConfig();
+    const isLoggedIn = !!config;
+    const apiClient = isLoggedIn ? new APIClient(config.api_url, config.api_key) : null;
+    const server = new McpServer({
+        name: 'langchain-mcp',
+        version: '1.0.0',
+    });
+    // search_langchain_docs
+    server.tool('search_langchain_docs', 'Search LangChain documentation. Returns relevant docs based on your query.', searchDocsSchema.shape, async (input) => {
+        if (!apiClient) {
+            return { content: [{ type: 'text', text: LOGIN_MESSAGE }] };
+        }
+        try {
+            const params = searchDocsSchema.parse(input);
+            const response = await apiClient.searchDocs(params);
+            const formatted = formatDocsResults(response.results);
+            const footer = `\n\n---\n_${response.results.length} results | ${response.usage.tokens_used} tokens | $${response.usage.credits_remaining.toFixed(2)} remaining_`;
+            return {
+                content: [{ type: 'text', text: formatted + footer }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: `Error: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // search_langchain_code
+    server.tool('search_langchain_code', 'Search LangChain source code. Returns relevant code snippets.', searchCodeSchema.shape, async (input) => {
+        if (!apiClient) {
+            return { content: [{ type: 'text', text: LOGIN_MESSAGE }] };
+        }
+        try {
+            const params = searchCodeSchema.parse(input);
+            const response = await apiClient.searchCode(params);
+            const formatted = formatCodeResults(response.results);
+            const footer = `\n\n---\n_${response.results.length} results | ${response.usage.tokens_used} tokens | $${response.usage.credits_remaining.toFixed(2)} remaining_`;
+            return {
+                content: [{ type: 'text', text: formatted + footer }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: `Error: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // search_langchain
+    server.tool('search_langchain', 'Hybrid search across LangChain docs and code.', searchHybridSchema.shape, async (input) => {
+        if (!apiClient) {
+            return { content: [{ type: 'text', text: LOGIN_MESSAGE }] };
+        }
+        try {
+            const params = searchHybridSchema.parse(input);
+            const response = await apiClient.searchHybrid(params);
+            // Format mixed results
+            const formatted = response.results.map((r, i) => {
+                const meta = r.metadata;
+                const isCode = r.repo !== 'docs';
+                const header = `## ${i + 1}. [${isCode ? 'Code' : 'Docs'}] ${meta.filePath}`;
+                if (isCode) {
+                    const lang = meta.language === 'python' ? 'python' : 'typescript';
+                    const content = r.content.length > 1500 ? r.content.slice(0, 1500) + '...' : r.content;
+                    return `${header}\n\n\`\`\`${lang}\n${content}\n\`\`\``;
+                }
+                else {
+                    const content = r.content.length > 1500 ? r.content.slice(0, 1500) + '...' : r.content;
+                    return `${header}\n\n${content}`;
+                }
+            }).join('\n\n---\n\n');
+            const footer = `\n\n---\n_${response.results.length} results | ${response.usage.tokens_used} tokens | $${response.usage.credits_remaining.toFixed(2)} remaining_`;
+            return {
+                content: [{ type: 'text', text: formatted + footer }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: `Error: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+    return server;
+}

package/package.json ADDED Viewed

@@ -0,0 +1,47 @@
+{
+  "name": "langchain-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for LangChain documentation and code search",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "langchain-mcp": "dist/bin/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "dev": "tsx watch src/index.ts",
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "cli": "tsx bin/cli.ts"
+  },
+  "keywords": [
+    "mcp",
+    "langchain",
+    "langgraph",
+    "langsmith",
+    "claude",
+    "ai",
+    "documentation"
+  ],
+  "author": "baixianger",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/baixianger/langchain-mcp"
+  },
+  "homepage": "https://langchain-mcp.xyz",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "commander": "^12.1.0",
+    "open": "^10.1.0",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0"
+  }
+}