🚀 MCP指令服务器（MCPInstructionServer）

MCP指令服务器（MCPInstructionServer）是一个基于TypeScript的模型上下文协议（Model Context Protocol）服务器，它能让AI助手发现并访问结构化的Markdown指令，为AI辅助任务提供了标准化的接口和集中式的指令管理方案。

🚀 快速开始

MCPInstructionServer允许像Claude这样的AI助手通过标准化接口访问集中式的Markdown指令库。通过将指令组织为Markdown文件，您可以创建集中的提示知识库、维护版本化且结构化的指导文档、让AI助手按需搜索和检索特定指令，以及建立一致的AI辅助任务模式。

安装

# 克隆仓库
git clone https://github.com/yourusername/MCPInstructionServer.git
cd MCPInstructionServer

# 安装依赖项
npm install

# 构建项目
npm run build

启动服务器

# 指定指令目录启动
npm start -- /path/to/instructions

# 或直接使用node
node dist/index.js /path/to/instructions

✨ 主要特性

• 简单的文件系统存储：只需目录中的Markdown文件。
• 递归目录扫描：通过层次结构组织指令。
• 路径安全：防止目录遍历和访问允许目录之外的文件。
• 自动摘要提取：从每个文档中提取H1标题和第一段。
• 模型上下文协议支持：与实现MCP的AI助手兼容。

📦 安装指南

先决条件

• Node.js 18+（用于ESM支持）。
• npm或yarn。
• 对TypeScript和Markdown的基本熟悉。

安装步骤

# 克隆仓库
git clone https://github.com/yourusername/MCPInstructionServer.git
cd MCPInstructionServer

# 安装依赖项
npm install

# 构建项目
npm run build

💻 使用示例

基础用法

启动服务器

# 指定指令目录启动
npm start -- /path/to/instructions

# 或直接使用node
node dist/index.js /path/to/instructions

创建指令

指令是简单的Markdown文件，扩展名为.md。每个文件应遵循以下结构：

# 指令标题

该指令目的的简要描述。此第一段将用作列表中指令的摘要。

## 详细信息

包含更多详细信息的其他部分...

## 示例

使用示例、代码片段等。

目录结构示例

instructions/
├── api/
│   ├── authentication.md
│   └── rate-limiting.md
├── design/
│   ├── color-system.md
│   └── typography.md
└── general/
    ├── code-review.md
    └── git-workflow.md

高级用法

访问指令

服务器提供两个MCP工具：

1. listInstructions

返回所有可用指令的列表及其ID和摘要。 示例响应：

id: api/authentication
summary: 身份验证API - 本文件概述了我们在系统中使用的身份验证协议。

id: design/typography
summary: 字体指南 - 本指南解释了我们的字体比例和使用规则。

2. readInstruction

接受一个指令ID并返回对应指令的完整内容。 示例请求：{ "id": "api/authentication" }

📚 详细文档

工作原理

服务器索引指定目录（及其子目录）中的Markdown文件，将每个文件视为指令文档。服务器提取每个文档的标题和第一段以生成可搜索的摘要。

AI助手可以执行以下操作：

1. 列出所有可用指令及其摘要。
2. 请求特定指令的ID。

🔧 技术细节

安全注意事项

• 服务器验证所有路径以防止目录遍历攻击。
• 只能访问指定指令目录中的文件。
• 没有写入功能，仅允许读取。

📄 许可证

本项目采用MIT许可证。

贡献

欢迎贡献！请随意提交Pull Request。