LLMDotfiles MCP Server

An MCP (Model Context Protocol) server for scanning AI-related dotfiles and configuration files, and expose them to the agent tool.

Overview

This MCP server provides access to a variety of dotfiles and configuration resources that help LLMs understand project context and guidelines. This is an experimental project that seek to detect and exposa all the different rules, guidelines, settings and configuration files the different agentic extensions make use of. This also includes the llm.txt proposal.

Installation

Requires NodeJS 18.x

Clone the project to any local folder you want. Do a npm install or pnpm install to download the dependencies. Use it as a project/workspace MCP server, this is an example config file:

{
  "mcp": {
    "LLMDotFiles": {
      "command": "npm",
      "args": [
        "start"
      ],
      "env": {
        "ProjectPath": "<ABSOLUTE PROJECT PATH>",
        "externalFolders": "<ABSOLUTE PATH TO EXTRA RULES>;<ANOTHER EXTRA PATH>"
      },
      "cwd": "<MCP SERVER INSTALLATION PATH>"
    }
  }
}

It can work as a global server, but since the project path is required, can only serve one project/workspace at a time.

Resources API

This server implements the MCP Resources API to provide access to dotfiles:

List Resources: Automatically scans the project to find available dotfiles
Read Resources: Access the content of specific dotfiles using their URIs
Read ALL Resources: returns the content of all the files detected by the server, concatenated in a single string.

Resource URIs

Resources are available using the file:/// URI scheme:

file:///{projectPath}/{filename}

The bulk of all resources can be obtained using LLMfiles:/// URI scheme:

Files and Folders Scanned

Project Files

llms.txt
ai-instructions.md
project-context.md
.github/copilot-instructions.md
.continuerules
.clinerules
.roorules
.kilocoderules

Project Folders

.vscode/rules
.roo/rules
.kilocode/rules
.cursor/rules
.continue/rules
.windsurf/rules

External Folders

~/Documents/Cline/Rules

License

MIT

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

A Model Context Protocol server that scans and exposes AI-related dotfiles and configuration files to LLM agents, helping them understand project context and guidelines.

Related MCP Servers

Toolkit MCP Server
cyanheads
A
security
A
license
A
quality
A Model Context Protocol server that provides LLM Agents with a comprehensive toolset for IP geolocation, network diagnostics, system monitoring, cryptographic operations, and QR code generation.
Last updated -
16
3
4
TypeScript
Apache 2.0
MCP Server Make
wrale
A
security
A
license
A
quality
A Model Context Protocol server that enables LLMs to safely execute make targets from a Makefile, allowing AI assistants to run tests, format code, and automate various development tasks through natural language interaction.
Last updated -
1
2
Python
MIT License
Linear MCP Server
emmett-deen
-
security
-
license
-
quality
A Model Context Protocol server implementation that enables AI assistants to interact with Linear project management systems, allowing them to create, retrieve, and modify data related to issues, projects, teams, and users.
Last updated -
20
2
TypeScript
SupaUI MCP Server
buoooou
A
security
F
license
A
quality
A Model Context Protocol server that enables AI agents to generate, fetch, and manage UI components through natural language interactions.
Last updated -
3
19
4
TypeScript

View all related MCP servers

LLMDotfiles MCP Server