🤖 AI Development Assistant MCP Server

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

Cursor 向けの Model Context Protocol（MCP）サーバーとして設計された、AI を活用した開発ツールキットへようこそ！このプロジェクトでは、カスタム AI ツールによるインテリジェントなコーディング支援を提供します。これは主にチュートリアル用のデモであり、本番環境向けのツールではないことにご注意ください。

✨ 機能

🎨 コードアーキテクト

高度な推論能力を持つ LLM を呼び出し、コーディングエージェント向けの計画と指示を生成します。

📸 スクリーンショットバディ

UI デザインのスクリーンショットを撮影し、Composer エージェントで使用します。

🔍 コードレビュー

git の差分を使ってコードレビューを実行します。

🚀 はじめに

1. 環境の設定

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

export const OPENAI_API_KEY = "your_key_here";
// Add any other keys you need

⚠️ セキュリティに関する注意：本番環境では、API キーをソースコードに直接保存することは推奨されません。これはローカルでの開発と学習のみを目的としています。Cursor MCP インターフェースで環境変数をインラインで設定することもできます。

2. インストール

npm install
# or
yarn install

3. サーバーのビルド

npm run build

4. Cursor への追加

このプロジェクトは、Cursor で MCP サーバーとして使用するために設計されています。設定方法は次のとおりです。

1. Cursor を開きます
2. Cursor Settings > Features > MCPに移動します
3. + Add New MCP Serverをクリックします
4. フォームに入力します：
   • 名前：AI Development Assistant
   • 種類：stdio
   • コマンド：node /path/to/your/project/dist/index.js

📘 ヒント：プロジェクトのビルド済み index.js ファイルへのフルパスが必要になる場合があります。

サーバーを追加すると、「Available Tools」にツールが表示されます。表示されない場合は、MCP サーバーセクションの右上にある更新ボタンをクリックしてみてください。

MCP の設定について詳しくは、Cursor MCP Documentationをご確認ください。

🛠️ ツールの使用

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

たとえば、Composer に次のように入力してみてください：

• 「このコードをベストプラクティスに沿ってレビューしてください」
• 「新しい機能の設計を手伝ってください」
• 「この UI スクリーンショットを分析してください」

エージェントはツールを呼び出す前に、承認を求めます。

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

📁 プロジェクト構成

src/
├── tools/
│   ├── architect.ts    # Code structure generator
│   ├── screenshot.ts   # Screenshot analysis tool
│   └── codeReview.ts   # Code review tool
├── env/
│   └── keys.ts         # Environment configuration (add your API keys here!)
└── index.ts           # Main entry point

🤝 コントリビューション

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

📝 ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています。詳細については、LICENSEファイルをご覧ください。

🐛 問題とサポート

バグを見つけた場合やサポートが必要な場合は、次の内容を記載して Issue を作成してください：

1. 実行しようとしていたこと
2. 代わりに起きたこと
3. 再現手順
4. お使いの環境の詳細

---

正直なところ、これはチュートリアル用のデモであり、本番環境向けのツールではないため、問題を修正する予定はほとんどありません。ただし、自由にフォークして、ご自身のものとしてお使いください！

開発者による、開発者のための ❤️ を込めて