# 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.

- **Type:** MCP server
- **Install:** `agentstack add mcp-druellan-llms-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [druellan](https://agentstack.voostack.com/s/druellan)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [druellan](https://github.com/druellan)
- **Source:** https://github.com/druellan/llms-mcp

## Install

```sh
agentstack add mcp-druellan-llms-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [druellan](https://github.com/druellan)
- **Source:** [druellan/llms-mcp](https://github.com/druellan/llms-mcp)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-druellan-llms-mcp
- Seller: https://agentstack.voostack.com/s/druellan
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.