LLMling MCP Server

Local setup required. This server has to be cloned and prepared on your machine before you register it in Claude Code.
1

Set the server up locally

Run this once to clone and prepare the server before adding it to Claude Code.

Run in terminal
pip install llmling
2

Register it in Claude Code

After the local setup is done, run this command to point Claude Code at the built server.

Run in terminal
claude mcp add llmling -- node "<FULL_PATH_TO_LLMLING>/dist/index.js"

Replace <FULL_PATH_TO_LLMLING>/dist/index.js with the actual folder you prepared in step 1.

README.md

A declarative framework for LLM resource management, prompts, and tools.

LLMling

A framework for declarative LLM application development focused on resource management, prompt templates, and tool execution.

This package provides the backend for two consumers: A MCP server and a pydantic-AI based Agent

Core Concepts

LLMLing provides a YAML-based configuration system for LLM applications. It allows to set up custom MPC servers serving content defined in YAML files.

  • Static Declaration: Define your LLM's environment in YAML - no code required
  • MCP Protocol: Built on the Machine Chat Protocol (MCP) for standardized LLM interaction
  • Component Types:
    • Resources: Content providers (files, text, CLI output, etc.)
    • Prompts: Message templates with arguments
    • Tools: Python functions callable by the LLM

The YAML configuration creates a complete environment that provides the LLM with:

  • Access to content via resources

  • Structured prompts for consistent interaction

  • Tools for extending capabilities

  • Written from ground up in modern python (minimum 3.12 required)

  • 100% typed

  • pydantic(-ai) based

An overview about the whole system:

graph TB
    subgraph LLMling[LLMling Core Package]
        RT[RuntimeConfig]

        subgraph Core_Components[Core Components]
            Resources[Resource Management- Load files/URLs- Process content- Watch changes]
            Tools[Tool System- Execute functions- Register new tools- OpenAPI integration]
            Prompts[Prompt System- Static/Dynamic prompts- Template rendering- Completion support]
        end

        CLI[Core CLI- config add/remove/list- resource list/load- tool list/execute- prompt list/render]

        Core_Components -->|YAML configuration| RT
        RT -->|All components| CLI
        CLI -->|modify| Core_Components
    end

    subgraph Direct_Access[mcp-server-llmlingDirect Component Access]
        MCP[HTTP/SSE Server- Start/Stop server]
        MCP_CLI[Server CLI- Start/Stop server]
        Injection[Injection Server- Inject componentsduring runtime]
    end

    subgraph Function_Access[llmling-agentAccess via Function Calling]
        LLM[LLM Integration- Function calling- Resource access- Tool execution- Structured output]
        Agent_CLI[Agent CL

Tools (3)

execute_toolExecutes a registered Python function or CLI command defined in the YAML configuration.
load_resourceLoads content from a defined resource such as files, URLs, or CLI output.
render_promptRenders a message template with provided arguments.

Configuration

claude_desktop_config.json
{"mcpServers": {"llmling": {"command": "llmling-server", "args": ["--config", "/path/to/config.yaml"]}}}

Try it

Load the content of my project documentation resource.
Execute the 'cleanup_logs' tool defined in my configuration.
Render the 'code-review' prompt with the current file content as an argument.
List all available resources and tools currently configured.

Frequently Asked Questions

What are the key features of LLMling?

Declarative YAML-based configuration for LLM environments. Resource management for files, URLs, and CLI output. Template-based prompt system with argument support. Tool execution system for Python functions and CLI commands. Built on the standardized Model Context Protocol (MCP).

What can I use LLMling for?

Standardizing LLM access to local project files and documentation. Creating reusable prompt templates for consistent LLM interactions. Exposing custom Python scripts as callable tools for LLMs. Managing complex LLM environments without writing boilerplate code.

How do I install LLMling?

Install LLMling by running: pip install llmling

What MCP clients work with LLMling?

LLMling works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep LLMling docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Need the old visual installer? Open Conare IDE.
Open Conare