# llms-mcp

An MCP (Model Context Protocol) server that exposes the `llms.txt` file from your project root as a resource for AI context enhancement.

## Overview

llms-mcp is a MCP server that looks for the `llms.txt` file in the root of your project directory and exposes it as a resource that can be consumed by MCP-compatible AI clients, based on the [llms.txt](https://llmstxt.org) proposed standard.

## Features

- **Detection**: Finds the `llms.txt` file in your project root
- **File Resource**: Exposes the file via `file://` URI for direct content access
- **Parsing**: Extracts local file references and external URLs from llms.txt content. Automatically exposes referenced local files and external URLs as additional MCP resources.
- **Fetching**: Can fetch external resources on-demand.

## Installation

### Prerequisites

- Node.js >= 18.0.0

### Setup

1. Clone or download this repository
2. Install dependencies:
   ```bash
   npm install
   ```

## Usage

### Running the Server

Start the MCP server:
```bash
npm start
```

### Test Mode

Validate that the server can detect your `llms.txt` file:
```bash
npm test
```

This will scan your project directory and show if an `llms.txt` file is detected without starting the server.

### Environment Configuration

The server uses the `ProjectPath` environment variable to determine the root directory to scan:

```bash
export ProjectPath="/path/to/your/project"
npm start
```

```powershell
$env:projectPath = "/path/to/your/project"; npm start
```

## MCP Client Configuration

### Claude Desktop/Cline/Roo/Kilocode

Add this configuration to your Claude Desktop config file:

```json
{
  "mcpServers": {
    "llms-mcp": {
      "command": "node",
      "args": ["path/to/llms-mcp/src/index.js"],
      "env": {
        "ProjectPath": "./"
      }
    }
  }
}
```

### Referenced Resources

The server automatically parses the `llms.txt` content and exposes referenced files and URLs as additional resources:

**Local Files:**
- Markdown-style file links: `[text](file.ext)`

**External URLs:**
- HTTP/HTTPS URLs: `https://example.com`
- URLs in markdown links: `[text](https://example.com)`

All local files are validated for existence before being exposed as resources. External URLs are exposed as-is and fetched on-demand when accessed.

## License

MIT License - see LICENSE file for details.

## Related Projects

- [llms.txt](https://llmstxt.org) - The llms.txt standard
- [Model Context Protocol](https://modelcontextprotocol.io) - MCP specification