Instruction

Provides a minimal MCP server that serves markdown instructions as tools to assist LLMs with contextual guidance.

typescript

0

GitHub Stars

typescript

Language

5 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "rach-instruction": {
      "command": "npx",
      "args": [
        "instruction-mcp",
        "-c",
        "instruction.yaml"
      ]
    }
  }
}

You run a minimal MCP server that serves markdown instructions as tools. It lets large language models access your curated guidance without boilerplate prompts, enabling consistent, context-rich interactions across teams and workflows.

How to use

Start the MCP server locally and connect it to an MCP client like Claude Desktop. You expose your tools by naming them and attaching markdown files that contain the instructions. When the client asks for a specific process, Claude calls the corresponding tool and receives the markdown content as context. If you want Claude to apply the instructions, include the word “following” in your prompt to have Claude apply the guidelines instead of merely retrieving them. You can explicitly request a tool by name to ensure precise behavior.

How to install

Prerequisites: Node.js and npm or npx should be available on your system.

Create your config and markdown files as described in the Quick Start.
Validate the configuration to ensure all referenced files exist.
Start the server in stdio mode so it can be driven by the MCP client.

Configuration and usage notes

The server is configured with a YAML file that maps tool names to human-friendly titles and to one or more instruction markdown files. You then run the MCP server so the client can request these tools by name.

version: "1"

tools:
  get_coding_standards:
    title: "Coding Standards"
    description: "Team coding standards and best practices"
    default: "general"
    instructions:
      general: "resources/standards/general.md"
      typescript: "resources/standards/typescript.md"
      testing: "resources/standards/testing.md"

Running and connecting

To validate and run a local MCP server, use the following workflow. Validate the configuration, then start the server in stdio mode so your MCP client can communicate with it.

npx instruction-mcp validate -c instruction.yaml
npx instruction-mcp -c instruction.yaml

Using with Claude Desktop

Add the MCP server configuration to the Claude Desktop client so Claude can call your tools automatically during conversations.

{
  "mcpServers": {
    "instruction_mcp": {
      "command": "npx",
      "args": ["instruction-mcp", "-c", "instruction.yaml"],
      "cwd": "/absolute/path/to/my-instructions"
    }
  }
}

Available tools

get_coding_standards

Tool that exposes the team Coding Standards and Best Practices as markdown-driven instructions for Claude to follow or retrieve.