Degenduel MCP

🚀 AI開発アシスタントMCPサーバー

このプロジェクトは、Cursorのモデルコンテキストプロトコル（MCP）サーバーとして設計されたAI駆動の開発ツールキットです。カスタムAIツールを通じて、スマートなコーディング支援を提供します。ただし、これは主にチュートリアル用のデモであり、本番環境での使用を想定したものではありません。

✨ 主な機能

🎨 コードアーキテクト

高度な推論LLMを呼び出して、コーディングエージェント用の計画や説明を生成します。

📸 スクリーンショットアシスタント

UI設計のスクリーンショットを使用し、コンポーザーエージェントと連携します。

🔍 コードレビュー

Gitの差分をトリガーとして、コードレビューを行います。

🚀 クイックスタート

1. 環境設定

まず、環境変数を設定する必要があります。src/env/keys.tsにファイルを作成します。

export const OPENAI_API_KEY = "your_key_here";
// 必要な他のキーを追加

⚠️ 重要な注意

本番環境では、APIキーをソースコードに直接保存することは推奨されません。これはローカル開発や学習目的でのみ使用されます。また、Cursor MCPインターフェイスで直接環境変数を設定することもできます。

2. インストール

npm install
# または
yarn install

3. 開発とビルドコマンド

# サーバーをビルド
npm run build-only

# 開発モード（変更を監視）
npm run dev

# サーバーを実行
npm run start

# PM2を使用してデプロイ
npm run pm2

# その他のPM2コマンド
npm run stop      # サーバーを停止
npm run restart   # サーバーを再起動
npm run logs      # サーバーのログを表示
npm run status    # サーバーの状態を確認

4. Cursorに追加

このプロジェクトは、CursorのMCPサーバーとして使用するように設計されています。設定方法は以下の通りです。

1. Cursorを開く
2. Cursor設定 > 機能 > MCPに移動する
3. + 新しいMCPサーバーを追加をクリックする
4. フォームに入力する：
   • 名前：AI開発アシスタント
   • タイプ：stdio
   • コマンド：node /path/to/your/project/build/index.js

📘 ヒント

プロジェクトのビルドファイルの完全パスを使用する必要がある場合があります。

サーバーを追加した後、「利用可能なツール」の下にツールが表示されるはずです。表示されない場合は、MCPサーバーセクションの右上にある更新ボタンをクリックしてみてください。 詳細なMCP設定については、Cursor MCPドキュメントを参照してください。

💻 使用例

基本的な使用法

設定が完了したら、CursorのComposerで直接これらのツールを使用できます。AIが自動的に関連するツールを提案するか、ツールの名前や説明を明示的に要求することもできます。

例えば、Composerで以下のように入力してみてください。

• “コードのベストプラクティスをチェック”
• “新しい機能のアーキテクチャを支援”
• “このUIスクリーンショットを分析”

エージェントは、ツールを使用する前にあなたの承認を求めます。

📘 ヒント

.cursorrulesファイルで、特定の状況でツールをどのように使用するかの指示を更新すると、エージェントが自動的にツールを使用します。

📚 ドキュメント

プロジェクト構造

src/
├── tools/
│   ├── architect.ts    # コード構造生成ツール
│   ├── screenshot.ts   # スクリーンショット分析ツール
│   └── codeReview.ts   # コードレビューツール
├── env/
│   └── keys.ts         # 環境設定（ここにあなたのAPIキーを追加！）
└── index.ts            # メインエントリポイント

🤝 コントリビューション

コントリビューションを歓迎します！プルリクエストを送信してください。

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。詳細はLICENSEを参照してください。

📋 注意事項

• このツールは常に信頼できるネットワーク上で使用し、APIキーの漏洩を防いでください。
• セキュリティとパフォーマンスを維持するために、定期的に依存関係を更新してください。

このプロジェクトがあなたの開発効率向上に役立つことを願っています。何か問題や提案があれば、お気軽にお問い合わせください。