mcpdoc  by langchain-ai

MCP server for exposing LLMs-TXT to IDEs

created 4 months ago
566 stars

Top 57.7% on sourcepulse

GitHubView on GitHub
Project Summary

This project provides an open-source Model Context Protocol (MCP) server to expose llms.txt documentation files to IDEs and AI applications, enabling auditable context retrieval for developers. It addresses the opacity of existing tools by offering fine-grained control over data sources and tool calls.

How It Works

The server acts as a bridge, allowing applications like Cursor, Windsurf, and Claude to query specified llms.txt files. It implements a fetch_docs tool that retrieves content from URLs within these files. A key design choice is strict domain access control, where only explicitly allowed domains can be queried, enhancing security and preventing unauthorized data access.

Quick Start & Requirements

  • Install uv: curl -LsSf https://astral.sh/uv/install.sh | sh
  • Run server: uvx --from mcpdoc mcpdoc --urls "LangGraph:https://langchain-ai.github.io/langgraph/llms.txt" --port 8082
  • Connect inspector: npx @modelcontextprotocol/inspector
  • Official Docs: https://github.com/langchain-ai/mcpdoc

Highlighted Details

  • Supports multiple IDE integrations (Cursor, Windsurf, Claude Code/Desktop).
  • Allows configuration via CLI, YAML, JSON, or programmatic Python usage.
  • Implements domain access control for security.
  • Uses Server-Sent Events (SSE) or stdio for transport.

Maintenance & Community

This project is part of the LangChain AI ecosystem. Further community and roadmap details are available via the LangChain community channels.

Licensing & Compatibility

The project is licensed under the MIT License, permitting commercial use and integration with closed-source applications.

Limitations & Caveats

The README notes that as of March 21, 2025, Claude Desktop and Claude Code may not support global rules, requiring manual prompt appending for rule enforcement. Python version compatibility issues might arise with certain integrations, necessitating explicit Python executable path specification.

Health Check
Last commit

1 week ago

Responsiveness

1 day

Pull Requests (30d)
6
Issues (30d)
5
Star History
217 stars in the last 90 days

Explore Similar Projects

Starred by Chip Huyen Chip Huyen(Author of AI Engineering, Designing Machine Learning Systems), Travis Fischer Travis Fischer(Founder of Agentic), and
1 more.

fastmcp by punkpeye

3.7%
2k
TypeScript framework for building MCP servers handling client sessions
created 7 months ago
updated 2 days ago
Feedback? Help us improve.