MCP Prompt Templates Server

MCP 提示词模板服务

一个 Model Context Protocol（MCP）服务，提供用于管理和提供可自定义提示词模板的“提示词”原语。此服务可创建、整理和提供提示词模板，供 MCP 客户端用于会议分析、内容摘要和博客文章撰写等各种任务。

功能

• 动态加载模板：自动从 templates 目录加载提示词模板
• YAML 配置：每个模板均使用 YAML 进行配置，便于定义元数据和参数
• 参数支持：模板支持动态参数，可在运行时替换
• 资源管理：通过 MCP 资源原语提供对 resources 目录中 Markdown 资源的访问
• 类型安全的实现：使用 TypeScript 构建，提升可靠性和开发体验
• 标准 MCP 提示词：实现 MCP 提示词原语，可与任何 MCP 客户端兼容
• 标准 MCP 资源：实现 MCP 资源原语，以访问静态内容和文档

演示

此 MCP 服务提供的“提示词”可直接在 Claude Desktop 中使用。具体操作如下：

1. 查看可用提示词

配置 MCP 服务后，点击 Claude 中的“+”图标，即可查看可用提示词列表：

服务会动态加载 templates 目录中的所有模板，并将其作为提示词提供。

2. 使用提示词

选择一个提示词（例如，today_city_weather_forecast），即可查看其必需参数：

填写必填字段：

• 城市：输入城市名称（例如，川崎的日文名称“川崎”）
• 日期：输入预报日期（例如，“2025-06-02”）

3. 执行提示词

点击“プロンプトを追加”（添加提示词）后，模板会根据你提供的参数进行处理：

服务会将模板中的占位符替换为你提供的值，并返回格式化后的提示词。

4. Claude 的响应

随后，Claude 会处理生成的提示词，并根据模板中的说明提供响应：

在此示例中，Claude 会分析天气数据，并按照模板中定义的格式，为指定城市和日期提供详细的天气预报。

安装

npm install

快速开始

1. 构建项目：

   npm run build
   

2. 启动服务：

   npm start
   

使用热重载进行开发：

npm run dev

DXT 包分发

此服务也可以打包为 DXT（桌面扩展）包，供用户在 Claude Desktop 中一键安装。

构建 DXT 包

1. 验证 DXT 配置：

   npm run dxt:validate
   

2. 构建 DXT 包：

   npm run dxt:build
   

3. 创建 .dxt 文件：

   npm run dxt:package
   

最终的 .dxt 文件会创建在 dist-dxt 目录中，可分发以便轻松安装。

安装 DXT 包

1. 打开 Claude Desktop
2. 前往 Settings > Extensions
3. 点击“Install Extension”，并选择 .dxt 文件
4. MCP 服务会自动完成配置，随时可用

创建模板

模板存放在 templates 目录中。每个模板都需要：

• 一个描述性名称的目录（例如，business_team_minutes_template）
• 一个用于定义元数据和参数的 config.yaml 文件
• 一个包含提示词模板的 template.md 文件

模板结构

templates/
└── your_custom_template/
    ├── config.yaml
    └── template.md

配置格式（config.yaml）

description: "A detailed description of what this template does"
version: "1.0"
arguments:
  - name: "argument_name"
    description: "Description of this argument"
    required: true
  - name: "optional_argument"
    description: "This argument is optional"
    required: false
metadata:
  tags:
    - tag1
    - tag2
  suggested_use: "When and how to use this template"
  output_format: "markdown"

模板格式（template.md）

模板使用 Mustache 风格的占位符表示参数：

# My Template

Date: {{ date }}
Title: {{ title }}

Content that uses the arguments provided by the user.
{{ main_content }}

MCP 服务配置

要将此服务与 MCP 客户端搭配使用，请将其添加到 MCP 设置配置中。

适用于 Claude Desktop

添加到 Claude Desktop 配置文件：

macOS：~/Library/Application Support/Claude/claude_desktop_config.json Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "prompt-templates": {
      "command": "node",
      "args": ["/path/to/mcp-prompt-templates-ts/dist/server.js"]
    }
  }
}

适用于开发

开发期间，可以直接使用 tsx：

{
  "mcpServers": {
    "prompt-templates": {
      "command": "npx",
      "args": ["tsx", "/path/to/mcp-prompt-templates-ts/src/server.ts"]
    }
  }
}

开发

项目结构

mcp-prompt-templates-ts/
├── src/
│   ├── server.ts    # Main MCP server implementation
│   └── client.ts    # Test client for development
├── templates/       # Prompt templates directory
├── resources/       # Static Markdown resources directory
├── dist/           # Compiled JavaScript output
├── package.json
├── tsconfig.json
└── README.md

添加新模板

1. 在 templates/ 中创建新目录
2. 添加包含模板配置的 config.yaml 文件
3. 添加包含提示词模板的 template.md 文件
4. 重启服务以加载新模板

管理资源

资源提供了一种通过 MCP 资源原语提供静态 Markdown 内容的方式。这些内容可以是文档、指南或任何 MCP 客户端可访问的参考资料。

资源结构

资源以 Markdown 文件的形式存储在 resources 目录中：

resources/
├── user-guide.md
├── api-documentation.md
└── troubleshooting-guide.md

资源格式

每个资源都是标准 Markdown 文件。第一行可以选择以 # 开头，用于提供描述：

# User Guide for Template Management

This guide explains how to create and manage prompt templates...

## Section 1
Content here...

添加资源

1. 在 resources/ 目录中创建 .md 文件
2. 添加 Markdown 内容
3. 可选择以 # 标题开头，作为资源描述
4. 重启服务以加载新资源

访问资源

资源会通过 MCP 资源原语自动公开，URI 格式为 resource://filename（不带 .md 扩展名）。MCP 客户端可以使用标准 MCP 资源操作列出和读取这些资源。

API 参考

此服务通过以下处理程序实现 MCP 提示词和资源原语：

提示词 API

列出提示词

返回所有可用提示词模板及其元数据。

获取提示词

检索指定的提示词模板，并将参数替换为提供的值。

参数：

• name：模板名称（目录名称）
• arguments：包含待替换参数值的对象

资源 API

列出资源

返回 resources 目录中的所有可用资源。

响应：

• 资源对象数组，包含 uri、name、description 和 mimeType

读取资源

检索指定资源的内容。

参数：

• uri：资源 URI（例如 resource://filename）

响应：

• 带有元数据的文本资源内容

许可证

MIT 许可证——详情请参阅 LICENSE 文件

故障排除

服务未加载模板

• 确保模板目录存在且包含有效的子目录
• 检查每个模板是否同时包含 config.yaml 和 template.md 文件
• 验证配置文件中的 YAML 语法

模板参数未替换

• 确保模板中的参数名称与 config.yaml 中定义的名称一致
• 使用正确的占位符语法：{{ argument_name }}
• 检查调用提示词时是否提供了必需参数

支持

如有问题、疑问或希望参与贡献，请访问 GitHub 仓库。