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文字に。

💡 仕組み

1. 頻繁に使う長いプロンプトがある

たとえば、300語のコードレビューチェックリスト、500語のデバッグガイド、または何ヶ月にもわたって完成させた複雑なペルソナの説明などです。

2. ショートカットとして保存する

{
  "command": "/myreview",
  "prompt": "[Your 300-word code review prompt here]"
}

3. すぐに使える

以前は: [300語を貼り付ける] + コード
今はただ入力するだけ: /myreview + コード

これだけです。あなたの個人用プロンプトライブラリが、いつでも手元にあります。

📚 完全なカスタマイズガイド

人気のプロンプトからの実際の例

例1: "完璧なコードアシスタント" プロンプト（400語以上）

これは開発者が繰り返し使う最も人気のあるプロンプトの1つです。

// 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 thorough - this code will go to production.

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: 繰り返し使用するプロンプトを特定する

頻繁に使うプロンプトを探します。

• 複雑なデバッグ指示
• 詳細なコードレビューチェックリスト
• 特定のフォーマット要件
• ロールプレイングシナリオ
• 分析フレームワーク

ステップ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: ショートカットを整理する

• カテゴリを使用する: coding, debugging, review, architecture, testing
• 簡単な検索のためにタグを追加する
• お気に入りをマークして、すぐにアクセスできるようにする
• 使用状況を追跡して、ライブラリを最適化する

追加できる人気のプロンプト

1. "5歳児に説明する" プロンプト → /eli5
2. "セキュリティ脆弱性を見つける" プロンプト → /security
3. "TypeScriptに変換する" プロンプト → /typescript
4. "単体テストを書く" プロンプト → /unittest
5. "パフォーマンスを最適化する" プロンプト → /perf
6. "APIドキュメント" プロンプト → /apidoc
7. "データベーススキーマ設計" プロンプト → /schema
8. "Reactのベストプラクティス" プロンプト → /react
9. "Python PEP8" プロンプト → /pep8
10. "システム設計面接" プロンプト → /sysdesign

🎯 対象ユーザー

• 精巧なデバッグやレビュープロンプトを持つ 開発者
• 詳細なシステム設計テンプレートを使用する アーキテクト
• 標準化されたコードレビューチェックリストを持つ チームリード
• 試行錯誤を繰り返して完璧なプロンプトを作り上げた エンジニア
• 別々のドキュメントでプロンプトを管理するのに疲れた 誰でも

✨ 主な機能

コア機能

• ⚡ 長いプロンプトの置換: 500語以上のプロンプトを簡単な /commands に置き換えます。
• 🎨 複雑なテンプレート: 複数段落にわたる指示、ペルソナ、思考の連鎖推論を保存します。
• 📝 カスタム作成: 注意深く作成したプロンプトを保存し、すぐに再利用できます。
• 🗂️ スマートな整理: ユースケース、プロジェクト、またはワークフローでカテゴライズします。
• ⭐ お気に入りシステム: 最も強力なプロンプトにすぐにアクセスできます。
• 🔍 インテリジェントな検索: キーワードまたは説明で適切なプロンプトを見つけます。

高度な機能

• 💾 永続的なストレージ: ショートカットはローカルに保存され、セッション間で同期されます。
• 📊 使用分析: 最も頻繁に使用するショートカットを追跡します。
• 🏷️ タグシステム: カスタムタグでショートカットを整理し、検索を容易にします。
• 📤 インポート/エクスポート: ショートカットコレクションを他の人と共有します。
• 🔄 バージョン管理: ショートカットの変更と更新を追跡します。

開発者体験

• 📚 TypeScript第一: 完全な型安全性とIntelliSenseサポートがあります。
• 🧪 包括的なテスト: 単体テスト、統合テスト、およびテストシナリオがあります。
• 📖 充実したドキュメント: APIリファレンス、アーキテクチャガイド、および例があります。
• 🔧 簡単な設定: JSONベースの設定で、環境変数による上書きが可能です。

🏗️ アーキテクチャ

Universal 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 Protocol: 完全なModel Context Protocol準拠
• Node.js/TypeScript: 最新の型安全なサーバー実装
• @modelcontextprotocol/sdk: プロトコル準拠の公式MCP SDK
• Prompt Manager: ショートカットコマンドのインテリジェントな解析と展開
• Local Database: 独自のカスタムショートカットの永続的なストレージ

📦 インストール

システム要件

• macOS: 12.0 (Monterey) 以降
• Node.js: 18.0以上 (LTS推奨)
• パッケージマネージャ: npm 8.0以上またはyarn 1.22以上
• Shortcutsアプリ: macOSに事前インストールされている必要があります。

🚀 クイックスタート

# Clone and setup
git clone <repository-url>
cd shortcut-mcp

# Install dependencies
npm install

# Build the project
npm run build

# Verify installation
npm run test

# Start the MCP server
npm start

🔧 設定

カスタム設定ファイルを作成します。

# Copy example config
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"

🚀 使用方法

クイックスタート例

基本的なショートカットの使用方法

会話の中でショート，/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"
→ 長所と短所のバランスの取れた分析を行います。

開発

詳細な開発手順については、docs/DEVELOPMENT.md を参照してください。

プロジェクト構造

shortcut-mcp/
├── src/
│   ├── index.ts          # メインサーバーのエントリーポイント
│   ├── server.ts         # MCPサーバーの実装
│   ├── shortcuts/        # ショートカットの対話ロジック
│   ├── types/           # TypeScriptの型定義
│   └── utils/           # ユーティリティ関数
├── docs/                # ドキュメント
├── examples/            # 例の設定と使用方法
├── tests/              # テストスイート
└── package.json        # Node.jsのパッケージ設定

コントリビューション

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

📄 ライセンス

MITライセンス - 詳細については LICENSE ファイルを参照してください。

🙏 謝辞

• Shortcutsアプリと自動化フレームワークを提供してくれたApple
• プロトコルの開発と標準化を行ってくれたMCPコミュニティ
• オープンソースの貢献者とTypeScriptエコシステム
• 初期のテスターとフィードバック提供者

🗺️ ロードマップ

コア機能

• [ ] 高度なテンプレート変数（条件ロジック、ループ）
• [ ] ショートカットコレクションと共有
• [ ] 多言語プロンプトテンプレート
• [ ] 使用分析と最適化の推奨事項

プラットフォーム統合

• [ ] すべてのMCPプラットフォームに対する自動補完提案
• [ ] プラットフォーム固有のUI強化
• [ ] モバイルアプリ互換性（iOS/Android）
• [ ] ウェブベースのショートカット管理インターフェース

エコシステム

• [ ] 外部プロンプトライブラリとの統合
• [ ] コミュニティショートカットマーケットプレイス
• [ ] カスタム動作のためのプラグインシステム
• [ ] サードパーティ統合のためのAPI

エンタープライズ機能

• [ ] チームショートカットの共有と管理
• [ ] ロールベースのアクセス制御
• [ ] 分析と使用報告
• [ ] 集中管理された設定管理