Advertise
MCP.so
Sign In

MCPInstructionServer MCP Server

@MartinSchlott

Repository

Basic information

Category

Other

License

MIT

Transports

stdio

Author

MartinSchlott

About MCPInstructionServer MCP Server

No overview available yet

#mcp#instruction-server#ai-assistant

MCPInstructionServer MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "MCPInstructionServer": {
      "command": "node",
      "args": [
        "dist/index.js",
        "/path/to/instructions"
      ]
    }
  }
}

MCPInstructionServer MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is MCPInstructionServer?

MCPInstructionServer is a TypeScript MCP server that lets AI assistants discover and access structured markdown instructions stored in a local directory. It indexes markdown files, extracts titles and summaries, and provides two MCP tools—listInstructions and readInstruction—for listing available documents and retrieving their full content.

How to use MCPInstructionServer?

Start the server by passing the path to your instructions directory: npm start -- /path/to/instructions or node dist/index.js /path/to/instructions. Instructions are plain .md files with an H1 title and a first‑paragraph summary. The server exposes two MCP tools: listInstructions to see all instruction IDs and summaries, and readInstruction with an id parameter to get the full document.

Key features of MCPInstructionServer

  • Simple filesystem‑based storage using markdown files in directories
  • Recursive directory scanning for hierarchical organization
  • Path security prevents directory traversal and access outside the allowed directory
  • Automatic extraction of H1 title and first paragraph as summaries
  • Model Context Protocol support for compatible AI assistants

Use cases of MCPInstructionServer

  • Provide an AI assistant with a centralized, versioned library of prompting guidelines.
  • Let Claude or other MCP‑compatible AIs search and retrieve specific instruction documents on demand.
  • Establish consistent, structured markdown guidance for AI‑assisted tasks across a team.
  • Maintain separate instruction sets (e.g., authentication, design, code review) in a folder hierarchy.

Frequently asked questions

1

What runtime does MCPInstructionServer require?

Node.js 18+ (for ESM support) and npm or yarn.

2

How are instructions stored and organized?

Instructions are simply `.md` files in a specified directory. The server scans recursively, so you can nest files in folders. Each file must have an H1 title and a first paragraph used as the summary.

3

Is there any writing capability?

No. MCPInstructionServer only provides read‑only access. It has no tools for creating, editing, or deleting files.

4

How does the server handle security?

It validates all requested paths to prevent directory traversal attacks and ensures only files within the specified instructions directory can be read.

5

Which MCP tools does the server provide?

Two tools: `listInstructions` (returns a list of document IDs and their summaries) and `readInstruction` (requires an `id` string and returns the full markdown content).

Comments

More Other MCP servers

ICSS

chokcoco

不止于 CSS

20.7K

Glasswarp

Glasswarp

See and control a real Windows PC you own — from any MCP client, locally or remotely. Observe (UIA + screenshots), click/type/drag/scroll, launch apps, owner Live View. BYOH: your machine, your key.

Klarix Intelligence Engine

Klarix

B2B competitive intelligence, live sales battlecards, 5-axis ICP prospect fit scoring, and tech stack teardowns over MCP and REST with cited public-web evidence.

Volley.sh

Volley

A good sequence diagram can solve almost any communication problem in engineering. Volley lets your agent write them as plain text, with the real request and response payloads on every arrow. It checks its own syntax wi

Health by Dr Brad

Dr Brad Stanfield

Health by Dr Brad works out a health plan from your own results: which screening is due at your age, and evidence-based suggestions, each with the reason and the published guideline or study behind it. Your record is one

Advertise