{
  "markdown": "<div align=\"center\">\n\n# LangChain MCP\n\n### Give your AI assistant complete knowledge of LangChain, LangGraph & LangSmith\n\n[![Website](https://img.shields.io/badge/Website-langchain--mcp.xyz-blue?style=flat-square)](https://langchain-mcp.xyz)\n[![npm version](https://img.shields.io/npm/v/langchain-mcp?style=flat-square)](https://www.npmjs.com/package/langchain-mcp)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](https://opensource.org/licenses/MIT)\n\n[Website](https://langchain-mcp.xyz) • [Installation](#installation) • [Features](#features) • [Documentation](#documentation)\n\n</div>\n\n---\n\n## Overview\n\n**LangChain MCP** is a Model Context Protocol (MCP) server that provides semantic search across the entire LangChain ecosystem. Build AI applications faster with instant access to documentation and source code for LangChain, LangGraph, LangSmith, and DeepAgents.\n\n<img src=\"img/homepage.png\" alt=\"LangChain MCP Homepage\" width=\"800\">\n\n## Features\n\n- **Semantic Search** - Natural language queries across all LangChain ecosystem docs\n- **Source Code Search** - Find code examples in Python and JavaScript repositories\n- **MCP Protocol** - Works seamlessly with Claude Code, Claude Desktop, Cursor, and any MCP-compatible client\n- **Production Ready** - Scalable API with authentication and usage tracking\n- **Fast & Accurate** - Powered by ChromaDB and OpenRouter embeddings\n\n## Installation\n\n### Quick Start (Recommended)\n\n```bash\n# Install globally\nnpm install -g langchain-mcp\n\n# Login with Google\nlangchain-mcp login\n\n# Add to Claude Code\nclaude mcp add langchain-mcp -- npx langchain-mcp\n```\n\n### Manual Configuration\n\nAdd the following configuration to your client's config file:\n\n**Claude Desktop**\n- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`\n- Windows: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n**Cursor**\n- macOS/Linux: `~/.cursor/mcp.json`\n- Windows: `%USERPROFILE%\\.cursor\\mcp.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"langchain-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\"langchain-mcp\"]\n    }\n  }\n}\n```\n\n## Usage\n\n### CLI Commands\n\n```bash\nlangchain-mcp login      # Login via Google OAuth\nlangchain-mcp status     # Check usage and remaining credits\nlangchain-mcp logout     # Logout and clear credentials\n```\n\n### Available MCP Tools\n\n| Tool | Description | Parameters |\n|------|-------------|------------|\n| `search_docs` | Search documentation, references, and tutorials | `query`, `limit` (default: 5) |\n| `search_langchain_code` | Search LangChain source code | `query`, `language` (py/js), `limit` |\n| `search_langgraph_code` | Search LangGraph source code | `query`, `language` (py/js), `limit` |\n| `search_deepagents_code` | Search DeepAgents source code | `query`, `language` (py/js), `limit` |\n\n## Pricing\n\n- Free tier available for new users\n- Donation bonus for supporters\n\n## Documentation\n\n### Self-deploy\n\n#### Project Structure\n\n```\nlangchain-MCP/\n├── packages/\n│   ├── ingest/              # Python - Data ingestion (uv)\n│   ├── api/                 # TypeScript - API server (Express)\n│   ├── mcp-server/          # TypeScript - MCP client (npm package)\n│   └── mcp-server-local/    # TypeScript - Local MCP server (dev)\n├── config/\n│   └── settings.json        # Shared configuration\n└── deploy.sh                # Deployment script\n```\n\n#### Architecture\n\n<img src=\"img/Architecture.png\" alt=\"Architecture\" width=\"600\">\n\n#### Setup Development Environment\n\n**1. Ingest Documentation & Source Code**\n\n```bash\ncd packages/ingest\nuv sync\nuv run ingest --list     # List available repositories\nuv run ingest docs       # Ingest documentation only\nuv run ingest            # Ingest all (docs + code)\n```\n\n**2. Run API Server**\n\n```bash\ncd packages/api\nnpm install\nnpm run dev              # Development server on port 3000\n```\n\n**3. Test Local MCP Server**\n\n```bash\ncd packages/mcp-server-local\nnpm install\nnpm run dev\n```\n\n#### Configuration\n\nAll settings in `config/settings.json`:\n\n```json\n{\n  \"embedding\": {\n    \"provider\": \"openrouter\",\n    \"model\": \"qwen/qwen3-embedding-8b\"\n  },\n  \"chromadb\": {\n    \"path\": \"./data/chroma\"\n  },\n  \"chunking\": {\n    \"docs\": { \"chunk_size\": 2000, \"chunk_overlap\": 200 },\n    \"code\": { \"chunk_size\": 4000, \"chunk_overlap\": 200 }\n  },\n  \"repos\": [\n    {\n      \"name\": \"langchain\",\n      \"url\": \"https://github.com/langchain-ai/langchain\",\n      \"type\": \"code\",\n      \"languages\": [\"python\", \"javascript\"]\n    }\n  ]\n}\n```\n\n#### Supported Embedding Providers\n\n- `sentence-transformer` (local)\n- `openai`\n- `cohere`\n- `google`\n- `ollama`\n- `openrouter` (default)\n\nSee [ChromaDB Integrations](https://docs.trychroma.com/integrations/chroma-integrations) for more options.\n\n## Deployment\n\nThe project includes automated deployment scripts for VPS hosting:\n\n```bash\n# Manual deployment\n./deploy.sh\n\n# GitHub Actions (production branch)\ngit push origin main:production\n```\n\nDeployment includes:\n- Code synchronization via rsync\n- Automatic npm installation and build\n- PM2 process management\n- Nginx static file serving\n- Environment variable management\n\n## Roadmap\n\n- [x] Semantic search across docs and code\n- [x] Google OAuth authentication\n- [x] Usage tracking and credits system\n- [x] MCP registry registration\n- [x] Claude Code, Desktop, and Cursor support\n- [ ] Rate limiting (per user / per IP)\n- [ ] Additional embedding model options\n- [ ] Local mode (no API key required)\n- [ ] Browser extension for quick searches\n- [ ] VSCode extension integration\n\n## Contributing\n\nForking and contributions are welcome!\n\n## Support\n\n- **Website**: [langchain-mcp.xyz](https://langchain-mcp.xyz)\n- **Issues**: [GitHub Issues](https://github.com/baixianger/langchain-mcp/issues)\n- **Donate**: Support development at [Ko-fi](https://ko-fi.com/baixianger)\n\n## License\n\nMIT License - see the [LICENSE](LICENSE) file for details.\n\n---\n\n<div align=\"center\">\n\n**Built with ❤️ by [baixianger](https://github.com/baixianger)**\n\n[Website](https://langchain-mcp.xyz) • [GitHub](https://github.com/baixianger/langchain-mcp) • [npm](https://www.npmjs.com/package/langchain-mcp)\n\n</div>\n",
  "bytes": 6112,
  "sha": "4d4251739a4d2ad7ed5182ed676439c77748e14eb9283873e4b4ee866a83cf5c",
  "repo_slug": "baixianger/langchain-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_baixianger_langchain_mcp_4011148f/readme"
}