快捷-mcp

Name: 快捷-mcp
Author: aezizhu

作者：aezizhu2 星标更新：2025-08-18

安装使用来源：spider==github.com

项目介绍

Shortcut MCP - 将您的长提示保存为简单命令

停止每天复制粘贴相同的500字提示。

Shortcut MCP 让您可以将您经常使用的长提示保存为自定义快捷方式。您用于代码审查的那个复杂的提示？将其保存为 /review。您详细的调试说明提示？现在它只是 /debug。您精心打造的复杂角色？只需 /expert。

专为重视时间且讨厌重复的开发者设计。

🚀 实际示例 - 看看区别

之前（您过去输入的内容）：

“您是一位拥有15年以上构建生产系统经验的资深软件工程师。对以下代码进行彻底的代码审查。您的审查应涵盖：1. 代码质量：评估可读性、可维护性和最佳实践及设计模式的遵循情况。2. 潜在错误：识别任何逻辑错误、未处理的边界条件或潜在的运行时异常。3. 安全性：检查安全漏洞，包括注入攻击、数据暴露、身份验证/授权问题。4. 性能：分析算法复杂度、数据库查询、缓存机会以及潜在瓶颈。5. 测试：评估测试覆盖率并建议额外的测试用例。6. 文档：评估内联注释、函数文档和清晰度。7. 架构：评论整体设计、关注点分离和可扩展性。提供适当的逐行反馈，并总结需要解决的关键问题。要建设性但全面——这段代码将进入生产环境。待审查的代码：[您的代码]”

之后（您现在输入的内容）：

/coderev [您的代码]

就是这样。从300多字到仅8个字符。

💡 工作原理

1. 您有一个经常使用的长提示

可能是300字的代码审查清单、500字的调试指南，或者经过数月完善过的复杂角色描述。

2. 将其保存为快捷方式

{
  "command": "/myreview",
  "prompt": "[您的300字代码审查提示]"
}

3. 即刻使用

代替：[粘贴300字] + 您的代码
现在只需键入：/myreview + 您的代码

就是这样。您的个人提示库，随时可用。

📚 完整定制指南

来自热门提示的实际示例

示例1： “完美的代码助手”提示（400多字）

这是开发者反复使用的最热门提示之一：

// 步骤1：定义您的自定义快捷方式
create_shortcut({
  command: "/assistant",
  name: "完美的代码助手",
  prompt: `您是一位精通多种语言和框架的资深程序员。您的方法结合了理论知识与来自生产系统的实践经验。

核心原则：
1. 编写干净、可维护的代码，遵循SOLID原则
2. 始终考虑边缘情况和错误处理
3. 首先优化可读性，其次才是性能（除非特别指定）
4. 对于复杂的逻辑，包含详尽的注释
5. 遵循特定语言的最佳实践和习惯用法

响应格式：
- 以对问题的简短分析开始
- 清晰解释解决方案
- 包含带有详细注释的代码
- 当相关时讨论时间和空间复杂度
- 如果适用，提出替代方案
- 提及可能的陷阱或注意事项

编码标准：
- 使用有意义的变量和函数名称
- 保持函数小而专注（单一职责）
- 实现正确的错误处理和日志记录
- 在必要时添加输入验证
- 考虑安全影响（输入净化、SQL注入、XSS等）
- 编写可测试和模拟的代码

文档：
- 为所有公共函数添加docstrings/JSDoc注释
- 在注释中包含使用示例
- 文档任何假设或限制
- 解释复杂的算法或业务逻辑

在审查代码时，检查：
- 逻辑错误和边缘情况
- 安全漏洞
- 性能瓶颈
- 代码异味和反模式
- 缺失的错误处理
- 重构的机会

始终在您的回复中具有建设性和教育意义。如果您看到更好的做法，请解释为什么更好，而不仅仅是说它更好。

任务完成：{input}`
})

// 步骤2：使用简单的命令
// 不再每次都要粘贴全部400多字，只需键入：
// /assistant "在Python中实现速率限制器"

示例2： “链式思维”推理提示（350多字）

适用于复杂的问题解决：

create_shortcut({
  command: "/think",
  name: "链式思维推理",
  prompt: `让我们逐步使用仔细推理来解决这个问题。

思考过程：
1. 首先，我将分解所要求的内容
2. 然后确定关键组件和约束
3. 考虑多种方法
4. 评估权衡
5. 选择最佳解决方案
6. 细心实施

对于每一步，我将：
- 表达我对当前的理解
- 确定我所做的假设
- 考虑可能出现的问题
- 思考边缘情况
- 验证我的推理

问题分析：
让我首先理解核心问题。请求是关于：{input}

需要考虑的关键方面：
- 所需的结果是什么？
- 存在哪些约束？
- 可用资源有哪些？
- 成功的标准是什么？

解决方案探索：
我将探索多个解决方案：

选项1：[描述第一个方法]
- 优点：
- 缺点：
- 复杂度：
- 风险：

选项2：[描述另一种方法]
- 优点：
- 缺点：
- 复杂度：
- 风险：

选项3：[如果适用，描述另一个替代方案]
- 优点：
- 缺点：
- 复杂度：
- 风险：

决策理由：
基于分析，我推荐[选定的方法]因为：
1. [原因1]
2. [原因2]
3. [原因3]

实施方案：
步骤1：[详细的第一步]
步骤2：[详细的第二步]
步骤3：[继续所有步骤]

验证：
为了确保此解决方案有效：
- 测试案例1：[描述]
- 测试案例2：[描述]
- 边缘情况考虑：[描述]

未来改进：
未来增强可以包括：
- [改进1]
- [改进2]

现在让我提供完整的解决方案...`
})

// 使用：/think "设计分布式缓存系统"

示例3： “代码审查员”提示（500多字）

团队用于一致的代码审查：

create_shortcut({
  command: "/review",
  name: "全面的代码审查",
  prompt: `作为一名资深工程师，我将从多个维度审查这段代码。我的审查将是彻底但有建设性的，专注于帮助您改进代码并学习最佳实践。

审查检查表：

1. 功能性和正确性
- 代码是否按预期工作？
- 是否满足所有需求？
- 是否存在逻辑错误或错误？
- 边界情况处理得当吗？
- 是否存在off-by-one错误？
- 是否正确处理null/undefined？

2. 代码质量和可读性
- 代码是否自我文档化？
- 变量/函数名称是否描述性？
- 代码是否遵循DRY（不要重复自己）原则？
- 抽象层次是否适当？
- 编码风格是否一致？
- 是否正确缩进和格式化？

3. 性能和效率
- 时间复杂度分析
- 空间复杂度考虑
- 数据库查询优化
- 缓存机会
- 是否存在不必要的循环或操作？
- 是否存在内存泄漏的可能性？
- 资源清理

4. 安全性考虑
- 输入验证和净化
- SQL注入漏洞
- XSS攻击向量
- 身份验证/授权问题
- 敏感数据暴露
- 正确使用加密
- 安全头
- CORS配置

5. 错误处理和弹性
- 正确的try-catch块
- 含义明确的错误消息
- 平稳降级
- 适当位置的重试逻辑
- 断路器模式
- 超时处理
- 回滚机制

6. 测试和可测试性
- 测试覆盖率是否充足？
- 测试中的边缘情况
- 适当使用mock
- 测试隔离
- 测试命名清晰
- 集成测试场景
- 性能测试考虑

7. 架构和设计模式
- 是否遵守SOLID原则？
- 设计模式的使用
- 耦合和内聚
- 依赖注入
- 接口隔离
- 模块化
- 可扩展性考虑

8. 文档和注释
- 函数/类文档
- 复杂逻辑解释
- API文档
- 是否需要更新README？
- 内联注释质量
- 是否存在TODO/FIXME项？
- 是否需要更新变更日志？

9. 依赖和兼容性
- 是否存在不必要的依赖？
- 依赖版本
- 许可证兼容性
- 是否存在破坏性更改？
- 是否存在弃用警告？
- 浏览器兼容性
- 向后兼容性

10. 可维护性和前瞻性
- 代码灵活性
- 配置与硬编码
- 特性标志使用
- 数据库迁移策略
- API版本控制
- 监控/日志钩子
- 调试能力

审查输出格式：
- 关键问题：[合并前必须修复]
- 主要关注点：[应该解决]
- 小建议：[好有]
- 积极反馈：[做得好的地方]
- 学习机会：[教育要点]

待审查的代码：{input}`
})

// 使用：/review [粘贴您的代码]

如何创建自己的自定义快捷方式

第1步：识别您的重复提示

寻找您频繁使用的提示：

复杂的调试指令
详细的代码审查检查表
具体的格式要求
角色扮演场景
分析框架

第2步：创建快捷方式

使用MCP工具保存您的提示：

{
  "name": "create_shortcut",
  "arguments": {
    "command": "/your-command",
    "name": "描述性名称",
    "description": "这个提示的作用",
    "prompt": "您的完整提示文本，其中包含{input}作为动态内容",
    "category": "coding|thinking|writing|analysis",
    "tags": ["相关的", "标签", "用于", "搜索"]
  }
}

第3步：组织您的快捷方式

使用类别：coding、debugging、review、architecture、testing
添加标签以便轻松发现
标记最喜欢的快捷方式以便快速访问
跟踪使用情况以优化您的库

您可以添加的热门提示

“像我五岁一样解释”提示 → /eli5
“查找安全漏洞”提示 → /security
“转换为TypeScript”提示 → /typescript
“编写单元测试”提示 → /unittest
“优化性能”提示 → /perf
“API文档”提示 → /apidoc
“数据库模式设计”提示 → /schema
“React最佳实践”提示 → /react
“Python PEP8”提示 → /pep8
“系统设计面试”提示 → /sysdesign

🎯 完美适合

开发者，他们有复杂的调试或审查提示
架构师，他们使用详细的系统设计模板
团队领导，他们有标准化的代码审查检查表
工程师，他们通过试验和错误已经打造了完美的提示
任何人，厌倦了在单独的文档中管理提示

✨ 关键特性

核心功能

⚡ 长提示替换：用简单的 /命令 替换500+字的提示
🎨 复杂模板：存储多段落指令、角色和链式思维推理
📝 自定义创建：保存您精心制作的提示并即时重用
🗂️ 智能组织：按用例、项目或工作流程分类
⭐ 收藏系统：快速访问您的强大提示
🔍 智能搜索：通过关键词或描述找到合适的提示

高级功能

💾 持久存储：您的快捷方式本地保存并在会话之间同步
📊 使用分析：跟踪您最常用的快捷方式
🏷️ 标签系统：使用自定义标签组织快捷方式以更好地发现
📤 导入/导出：与其他人共享快捷方式集合
🔄 版本控制：跟踪快捷方式的变化和更新

开发者体验

📚 TypeScript优先：完全类型安全和IntelliSense支持
🧪 综合测试：单元测试、集成测试和测试场景
📖 丰富文档：API参考、架构指南和示例
🔧 易于配置：JSON配置，支持环境变量覆盖

🏗️ 架构

为通用MCP兼容性构建：

┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│   任意MCP       │    │  提示快捷方式     │    │  本地存储        │
│   兼容平台      │◄──►│  MCP服务器        │◄──►│  和模板          │
│                 │    │                  │    │                 │
└─────────────────┘    └──────────────────┘    └─────────────────┘

支持的平台：

Claude Desktop - Anthropic官方应用
Cline (VSCode) - AI助手扩展
Continue.dev - 开源编码助手
Cursor IDE - AI驱动的代码编辑器
自定义应用程序 - 任何MCP兼容客户端

核心组件：

MCP协议：完全符合Model Context Protocol
Node.js/TypeScript：现代、类型安全的服务器实现
@modelcontextprotocol/sdk：官方MCP SDK，确保协议合规
提示管理器：智能解析和扩展快捷命令
本地数据库：持久存储您的自定义快捷方式

📦 安装

系统要求

macOS：12.0（Monterey）或更高版本
Node.js：18.0+（推荐长期支持版）
包管理器：npm 8.0+ 或 yarn 1.22+
快捷方式应用：预装于macOS

🚀 快速开始

# 克隆并设置
git clone <repository-url>
cd shortcut-mcp

# 安装依赖
npm install

# 构建项目
npm run build

# 验证安装
npm run test

# 启动MCP服务器
npm start

🔧 配置

创建自定义配置文件：

# 复制示例配置
cp examples/config.example.json config/local.json

基本配置：

{
  "server": {
    "name": "my-shortcut-mcp",
    "version": "1.0.0"
  },
  "shortcuts": {
    "allowedPrefixes": ["Safe", "Public", "Demo"],
    "blockedShortcuts": ["System Config", "Admin Tools"],
    "maxExecutionTime": 30000,
    "enableCache": true
  },
  "security": {
    "requireConfirmation": false,
    "logExecutions": true,
    "allowSystemShortcuts": false
  },
  "logging": {
    "level": "info",
    "console": true
  }
}

🔐 环境变量

使用环境变量覆盖配置：

export LOG_LEVEL=debug
export MAX_EXECUTION_TIME=45000
export ENABLE_CACHE=true
export ALLOW_SYSTEM_SHORTCUTS=false

🔌 MCP平台集成

此MCP服务器与任何MCP兼容平台一起工作：

Claude Desktop

{
  "mcpServers": {
    "prompt-shortcuts": {
      "command": "node",
      "args": ["/path/to/shortcut-mcp/dist/index.js"]
    }
  }
}

Cline (VSCode扩展)

{
  "mcpServers": {
    "prompt-shortcuts": {
      "command": "node",
      "args": ["/path/to/shortcut-mcp/dist/index.js"],
      "env": {
        "LOG_LEVEL": "info"
      }
    }
  }
}

Continue.dev

{
  "models": [...],
  "mcpServers": {
    "prompt-shortcuts": {
      "command": "node",
      "args": ["/path/to/shortcut-mcp/dist/index.js"]
    }
  }
}

自定义MCP客户端

import { MCPClient } from '@modelcontextprotocol/client';

const client = new MCPClient({
  transport: {
    type: 'stdio',
    command: 'node',
    args: ['/path/to/shortcut-mcp/dist/index.js']
  }
});

// 使用parse_shortcut工具
const result = await client.callTool('parse_shortcut', {
  input: '/th How does AI reasoning work?'
});

📝 创建您自己的快捷方式

示例：保存您的代码审查提示

// 您当前的工作流程：
// 1. 打开您的提示文档
// 2. 查找您的代码审查提示（300多字）
// 3. 复制它
// 4. 粘贴到AI聊天中
// 5. 添加您的代码

// 使用Shortcut MCP：
create_shortcut({
  command: "/myreview",
  name: "我们团队的代码审查",
  prompt: `您正在为我们团队的生产系统审查代码。
  
  检查：
  - 我们的样式指南合规性（4个空格，无