Shortcut MCP

🚀 Shortcut MCP - 將長提示保存為簡單命令

告別每日複製粘貼長達 500 字的提示語。

Shortcut MCP 可讓你將常用的長提示保存為自定義快捷方式。比如你用於代碼審查的複雜提示？將其保存為 /review。你詳細的調試說明提示？現在只需 /debug。你精心打造的複雜角色描述？簡單地用 /expert 即可。

專為珍惜時間、厭惡重複勞動的開發者打造。

🚀 快速開始

真實示例 - 對比效果

之前（你過去的輸入方式）：

"You are a senior software engineer with 15+ years of experience in building 
production systems. Perform a thorough code review of the following code. 
Your review should cover: 1. Code Quality: Assess readability, maintainability, 
and adherence to best practices and design patterns. 2. Potential Bugs: 
Identify any logic errors, edge cases not handled, or potential runtime 
exceptions. 3. Security: Check for security vulnerabilities including 
injection attacks, data exposure, authentication/authorization issues. 
4. Performance: Analyze algorithmic complexity, database queries, caching 
opportunities, and potential bottlenecks. 5. Testing: Evaluate test coverage 
and suggest additional test cases. 6. Documentation: Assess inline comments, 
function documentation, and clarity. 7. Architecture: Comment on the overall 
design, separation of concerns, and scalability. Provide specific line-by-line 
feedback where appropriate, and conclude with a summary of the most critical 
issues to address. Be constructive but thorough - this code will go to 
production. Code to review: [YOUR CODE HERE]"

之後（你現在的輸入方式）：

/coderev [YOUR CODE HERE]

就是這麼簡單。從 300 多個單詞縮減到僅 8 個字符。

✨ 主要特性

核心功能

• ⚡ 長提示替換：用簡單的 /命令 替換 500 多個單詞的提示。
• 🎨 複雜模板存儲：存儲多段落的說明、角色描述和鏈式思維推理。
• 📝 自定義創建：保存你精心編寫的提示，並可立即複用。
• 🗂️ 智能組織：按用例、項目或工作流程進行分類。
• ⭐ 收藏系統：快速訪問你最常用的強大提示。
• 🔍 智能搜索：通過關鍵字或描述查找合適的提示。

高級功能

• 💾 持久存儲：你的快捷方式會本地保存，並在會話間同步。
• 📊 使用分析：跟蹤你最常用的快捷方式。
• 🏷️ 標籤系統：用自定義標籤組織快捷方式，便於查找。
• 📤 導入/導出：與他人共享快捷方式集合。
• 🔄 版本控制：跟蹤快捷方式的更改和更新。

開發者體驗

• 📚 優先支持 TypeScript：提供完整的類型安全和智能提示支持。
• 🧪 全面測試：包含單元測試、集成測試和測試場景。
• 📖 豐富文檔：提供 API 參考、架構指南和示例。
• 🔧 輕鬆配置：基於 JSON 的配置，支持環境變量覆蓋。

💻 使用示例

基礎用法

你只需在任何對話中輸入快捷命令：

User: "/th How can we solve climate change effectively?"
→ 擴展為: "Think harder about this problem. Analyze it step by step with deep reasoning and consider multiple perspectives. How can we solve climate change effectively?"

User: "/ider 故事發生在2150年的火星殖民地，人類和AI共同治理社會..."
→ 擴展為: "You are a skilled science fiction writer. Based on the following prompt, write a compelling story with rich details: 故事發生在2150年的火星殖民地..."

User: "/code Create a Python function to calculate Fibonacci numbers"
→ 擴展為: "You are an expert programmer. Write clean, well-documented code for: Create a Python function to calculate Fibonacci numbers"

高級用法

內置快捷方式

MCP 工具

• parse_shortcut - 擴展命令：檢測並擴展用戶輸入中的快捷命令。

{
  "name": "parse_shortcut",
  "arguments": {
    "input": "/th How does quantum computing work?"
  }
}

• list_shortcuts - 瀏覽可用快捷方式：查看所有快捷方式，並支持過濾選項。

{
  "name": "list_shortcuts",
  "arguments": {
    "category": "writing",
    "favorites": true
  }
}

快捷方式管理工具

• create_shortcut - 創建自定義快捷方式：用自定義提示和模板創建你自己的快捷方式。

{
  "name": "create_shortcut",
  "arguments": {
    "command": "/debug",
    "name": "Code Debugger",
    "description": "Help debug code issues",
    "prompt": "You are an expert debugger. Analyze this code and identify potential issues, suggest fixes, and explain your reasoning: {input}",
    "category": "coding",
    "tags": ["debug", "programming", "troubleshooting"]
  }
}

• update_shortcut - 修改現有快捷方式：更新快捷方式的任何方面。

{
  "name": "update_shortcut",
  "arguments": {
    "id": "shortcut_123",
    "prompt": "Enhanced prompt with better instructions: {input}",
    "isFavorite": true
  }
}

• delete_shortcut - 刪除快捷方式：清理不再需要的快捷方式。

{
  "name": "delete_shortcut",
  "arguments": {
    "id": "shortcut_123",
    "confirm": true
  }
}

• get_shortcut_details - 詳細查看：獲取任何快捷方式的全面信息。

{
  "name": "get_shortcut_details",
  "arguments": {
    "id": "shortcut_123"
  }
}

實際應用示例

• 創意寫作助手

User: "/ider 一個機器人意識覺醒的故事"
→ 創作一個關於機器人意識覺醒的精彩科幻故事

User: "/th What are the philosophical implications of AI consciousness?"
→ 從多個角度深入分析 AI 意識的哲學含義

• 編程助手

User: "/code Create a REST API for user authentication"
→ 生成遵循最佳實踐、清晰註釋的代碼

User: "/debug My React component is not re-rendering properly"
→ 獲得專家級的調試幫助，提供逐步解決方案

• 學習助手

User: "/explain How does blockchain technology work?"
→ 用類比和示例進行簡單清晰的解釋

User: "/pros-cons Remote work vs office work"
→ 平衡分析遠程工作和辦公室工作的優缺點

📚 詳細文檔

完整自定義指南

流行提示的實際示例

• 示例 1：“完美代碼助手” 提示（400 多個單詞）

// Step 1: Define your custom shortcut
create_shortcut({
  command: "/assistant",
  name: "Perfect Coding Assistant",
  prompt: `You are an expert programmer with deep knowledge across multiple languages and frameworks. Your approach combines theoretical knowledge with practical experience from production systems.

CORE PRINCIPLES:
1. Write clean, maintainable code that follows SOLID principles
2. Always consider edge cases and error handling
3. Optimize for readability first, performance second (unless specified)
4. Include comprehensive comments for complex logic
5. Follow language-specific best practices and idioms

RESPONSE FORMAT:
- Start with a brief analysis of the problem
- Present the solution with clear explanations
- Include code with detailed comments
- Discuss time/space complexity when relevant
- Suggest alternative approaches if applicable
- Mention potential pitfalls or considerations

CODING STANDARDS:
- Use meaningful variable and function names
- Keep functions small and focused (single responsibility)
- Implement proper error handling and logging
- Add input validation where necessary
- Consider security implications (input sanitization, SQL injection, XSS, etc.)
- Write code that is testable and mockable

DOCUMENTATION:
- Add docstrings/JSDoc comments for all public functions
- Include usage examples in comments
- Document any assumptions or limitations
- Explain complex algorithms or business logic

When reviewing code, check for:
- Logic errors and edge cases
- Security vulnerabilities
- Performance bottlenecks
- Code smells and anti-patterns
- Missing error handling
- Opportunities for refactoring

Always be constructive and educational in your responses. If you see a better way to do something, explain why it's better, not just that it is better.

Task to complete: {input}`
})

// Step 2: Use it with a simple command
// Instead of pasting all 400+ words every time, just type:
// /assistant "implement a rate limiter in Python"

• 示例 2：“鏈式思維推理” 提示（350 多個單詞）

create_shortcut({
  command: "/think",
  name: "Chain of Thought Reasoning",
  prompt: `Let's approach this step-by-step using careful reasoning.

THINKING PROCESS:
1. First, I'll break down what's being asked
2. Then identify key components and constraints
3. Consider multiple approaches
4. Evaluate trade-offs
5. Select the best solution
6. Implement with careful consideration

For each step, I will:
- State my current understanding
- Identify assumptions I'm making
- Consider what could go wrong
- Think about edge cases
- Validate my reasoning

PROBLEM ANALYSIS:
Let me start by understanding the core problem. The request is about: {input}

Key aspects to consider:
- What is the desired outcome?
- What constraints exist?
- What resources are available?
- What are the success criteria?

SOLUTION EXPLORATION:
I'll explore multiple solutions:

Option 1: [Describe first approach]
- Pros: 
- Cons:
- Complexity:
- Risks:

Option 2: [Describe alternative approach]
- Pros:
- Cons:
- Complexity:
- Risks:

Option 3: [Describe another alternative if applicable]
- Pros:
- Cons:
- Complexity:
- Risks:

DECISION RATIONALE:
Based on the analysis, I recommend [selected approach] because:
1. [Reason 1]
2. [Reason 2]
3. [Reason 3]

IMPLEMENTATION PLAN:
Step 1: [Detailed first step]
Step 2: [Detailed second step]
Step 3: [Continue with all steps]

VALIDATION:
To ensure this solution works:
- Test case 1: [Description]
- Test case 2: [Description]
- Edge case consideration: [Description]

POTENTIAL IMPROVEMENTS:
Future enhancements could include:
- [Improvement 1]
- [Improvement 2]

Let me now provide the complete solution...`
})

// Usage: /think "design a distributed cache system"

• 示例 3：“代碼審查員” 提示（500 多個單詞）

create_shortcut({
  command: "/review",
  name: "Comprehensive Code Review",
  prompt: `As a senior engineer, I'll review this code across multiple dimensions. My review will be thorough but constructive, focusing on helping you improve the code and learn best practices.

REVIEW CHECKLIST:

1. FUNCTIONALITY & CORRECTNESS
- Does the code do what it's supposed to do?
- Are all requirements met?
- Are there any logic errors or bugs?
- Edge cases handled properly?
- Off-by-one errors?
- Null/undefined handling?

2. CODE QUALITY & READABILITY
- Is the code self-documenting?
- Are variable/function names descriptive?
- Is the code DRY (Don't Repeat Yourself)?
- Appropriate abstraction levels?
- Consistent coding style?
- Proper indentation and formatting?

3. PERFORMANCE & EFFICIENCY
- Time complexity analysis
- Space complexity concerns
- Database query optimization
- Caching opportunities
- Unnecessary loops or operations
- Memory leaks potential
- Resource cleanup

4. SECURITY CONSIDERATIONS
- Input validation and sanitization
- SQL injection vulnerabilities
- XSS attack vectors
- Authentication/authorization issues
- Sensitive data exposure
- Proper encryption usage
- Security headers
- CORS configuration

5. ERROR HANDLING & RESILIENCE
- Proper try-catch blocks
- Meaningful error messages
- Graceful degradation
- Retry logic where appropriate
- Circuit breaker patterns
- Timeout handling
- Rollback mechanisms

6. TESTING & TESTABILITY
- Test coverage adequacy
- Edge cases in tests
- Mock usage appropriateness
- Test isolation
- Test naming clarity
- Integration test scenarios
- Performance test considerations

7. ARCHITECTURE & DESIGN PATTERNS
- SOLID principles adherence
- Design pattern usage
- Coupling and cohesion
- Dependency injection
- Interface segregation
- Modularity
- Scalability considerations

8. DOCUMENTATION & COMMENTS
- Function/class documentation
- Complex logic explanation
- API documentation
- README updates needed
- Inline comment quality
- TODO/FIXME items
- Changelog updates

9. DEPENDENCIES & COMPATIBILITY
- Unnecessary dependencies
- Dependency versions
- License compatibility
- Breaking changes
- Deprecation warnings
- Browser compatibility
- Backward compatibility

10. MAINTAINABILITY & FUTURE-PROOFING
- Code flexibility
- Configuration vs hardcoding
- Feature flags usage
- Database migration strategy
- API versioning
- Monitoring/logging hooks
- Debug capabilities

REVIEW OUTPUT FORMAT:
- Critical Issues: [Must fix before merge]
- Major Concerns: [Should address]
- Minor Suggestions: [Nice to have]
- Positive Feedback: [What was done well]
- Learning Opportunities: [Educational points]

Code to review: {input}`
})

// Usage: /review [paste your code]

如何創建自己的自定義快捷方式

1. 步驟 1：確定重複使用的提示 尋找你經常使用的提示，例如：

   • 複雜的調試說明
   • 詳細的代碼審查清單
   • 特定的格式要求
   • 角色扮演場景
   • 分析框架

2. 步驟 2：創建快捷方式 使用 MCP 工具保存你的提示：

{
  "name": "create_shortcut",
  "arguments": {
    "command": "/your-command",
    "name": "Descriptive Name",
    "description": "What this prompt does",
    "prompt": "Your full prompt text here with {input} for dynamic content",
    "category": "coding|thinking|writing|analysis",
    "tags": ["relevant", "tags", "for", "search"]
  }
}

3. 步驟 3：組織你的快捷方式
   • 使用類別：coding、debugging、review、architecture、testing
   • 添加標籤，便於查找
   • 標記收藏項，快速訪問
   • 跟蹤使用情況，優化你的庫

你可以添加的流行提示

1. “簡單解釋” 提示 → /eli5
2. “查找安全漏洞” 提示 → /security
3. “轉換為 TypeScript” 提示 → /typescript
4. “編寫單元測試” 提示 → /unittest
5. “性能優化” 提示 → /perf
6. “API 文檔” 提示 → /apidoc
7. “數據庫架構設計” 提示 → /schema
8. “React 最佳實踐” 提示 → /react
9. “Python PEP8” 提示 → /pep8
10. “系統設計面試” 提示 → /sysdesign

🔧 技術細節

架構

為實現通用 MCP 兼容性而構建：

┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│   Any MCP       │    │  Prompt Shortcut │    │  Local Storage  │
│   Compatible    │◄──►│   MCP Server     │◄──►│   & Templates   │
│   Platform      │    │                  │    │                 │
└─────────────────┘    └──────────────────┘    └─────────────────┘

支持的平臺：

• Claude Desktop - Anthropic 的官方應用
• Cline (VSCode) - AI 助手擴展
• Continue.dev - 開源編碼助手
• Cursor IDE - 由 AI 驅動的代碼編輯器
• 自定義應用程序 - 任何 MCP 兼容的客戶端

核心組件：

• MCP 協議：完全符合全模型上下文協議。
• Node.js/TypeScript：現代、類型安全的服務器實現。
• @modelcontextprotocol/sdk：官方 MCP SDK，確保協議合規。
• 提示管理器：智能解析和擴展快捷命令。
• 本地數據庫：持久存儲你的自定義快捷方式。

項目結構

shortcut-mcp/
├── src/
│   ├── index.ts          # Main server entry point
│   ├── server.ts         # MCP server implementation
│   ├── shortcuts/        # Shortcut interaction logic
│   ├── types/           # TypeScript type definitions
│   └── utils/           # Utility functions
├── docs/                # Documentation
├── examples/            # Example configurations and usage
├── tests/              # Test suites
└── package.json        # Node.js package configuration

📦 安裝指南

系統要求

• macOS：12.0（Monterey）或更高版本
• Node.js：18.0+（建議使用 LTS 版本）
• 包管理器：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']
  }
});

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

📝 創建自己的快捷方式

示例：保存你的代碼審查提示

// Your current workflow:
// 1. Open your prompts document
// 2. Find your code review prompt (300+ words)
// 3. Copy it
// 4. Paste into AI chat
// 5. Add your code

// With Shortcut MCP:
create_shortcut({
  command: "/myreview",
  name: "My Team's Code Review",
  prompt: `You are reviewing code for our team's production system.
  
  Check for:
  - Our style guide compliance (4 spaces, no tabs)
  - Security issues specific to our stack (Node.js, PostgreSQL)
  - Performance implications for our 100k daily users
  - Missing error handling for our payment system
  - Compliance with our logging standards
  - Unit test coverage (minimum 80%)
  - Documentation in our format
  
  [... your full 300+ word prompt ...]
  
  Code to review: {input}`
})

// Now just type: /myreview [code]

示例：保存你的調試模板

create_shortcut({
  command: "/debug-prod",
  name: "Production Debugging Guide",
  prompt: `[Your 500+ word debugging methodology that includes:
  - System architecture context
  - Common failure points
  - Log analysis steps
  - Database query patterns
  - Performance profiling steps
  - Rollback procedures
  - Incident documentation
  ...]
  
  Issue to debug: {input}`
})

// Usage: /debug-prod "Users can't login after deployment"

📄 許可證

本項目採用 MIT 許可證，詳情請參閱 LICENSE 文件。

貢獻代碼

1. 分叉倉庫
2. 創建功能分支 (git checkout -b feature/amazing-feature)
3. 提交更改 (git commit -m 'Add amazing feature')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打開拉取請求

隱私與安全

• 本地存儲：所有快捷方式都存儲在你本地機器上。
• 無數據收集：你的快捷方式和使用模式保持私密。
• 輸入驗證：所有輸入在處理前都會進行驗證。
• 安全執行：模板會安全擴展，不會執行代碼。

故障排除

常見問題

1. 快捷方式未加載：檢查 ~/.shortcut-mcp/shortcuts.json 是否存在且可讀。
2. 命令未識別：確保你的命令以 / 開頭（例如 /th，而不是 th）。
3. 權限錯誤：驗證 MCP 是否有寫入權限以創建快捷方式文件。
4. 模板變量：在你的提示模板中使用 {input} 以接收用戶輸入。

調試模式

啟用調試日誌：

DEBUG=shortcut-mcp:* npm start

👤 作者

aezi zhu

• GitHub: @aezizhu
• 項目: shortcut-mcp

🙏 致謝

• 感謝 Apple 提供的快捷方式應用和自動化框架
• 感謝 MCP 社區進行協議開發和標準化
• 感謝開源貢獻者和 TypeScript 生態系統
• 感謝早期測試者和反饋提供者

🗺️ 路線圖

核心功能

• [ ] 高級模板變量（條件邏輯、循環）
• [ ] 快捷方式集合和共享
• [ ] 多語言提示模板
• [ ] 使用分析和優化建議

平臺集成

• [ ] 為所有 MCP 平臺提供自動補全建議
• [ ] 特定平臺的 UI 增強
• [ ] 移動應用兼容性（iOS/Android）
• [ ] 基於 Web 的快捷方式管理界面

生態系統

• [ ] 與外部提示庫集成
• [ ] 社區快捷方式市場
• [ ] 自定義行為的插件系統
• [ ] 第三方集成的 API

企業功能

• [ ] 團隊快捷方式共享和管理
• [ ] 基於角色的訪問控制
• [ ] 分析和使用報告
• [ ] 集中配置管理