promptz.dev MCP Server

promptz.dev MCP サーバー

promptz.dev のプロンプトに Amazon Q Developer から直接アクセスできます。

この MCP サーバーを使うと、コピー＆ペーストすることなく promptz.dev API のプロンプトにアクセスでき、開発ワークフローにおけるコンテキストの切り替えや手間を減らせます。

機能

promptz.dev MCP サーバーは、次の 2 つの主な機能を提供します。

1. プロンプト - プロンプトを検索して実行する関数です。
2. ルール - プロジェクトのルールを検索し、他のツールと連携してワークスペースに追加・更新する関数です。

使用例

サーバーを Amazon Q Developer に接続すると、次のように自然言語で使用できます。

• 「JavaScript に関する CLI プロンプトを検索して」
• 「『React Component Documentation』というプロンプトを見せて」
• 「React Component Documentation プロンプトを使ってドキュメントを改善して」
• 「CDK Development のプロジェクトルールを探して」
• 「CDK Project Structure のプロジェクトルールをワークスペースに追加して」

インストール

ステップ 1：API 認証情報を取得する

1. https://promptz.dev/mcp にアクセスします
2. API キー、API URL などの MCP 設定、または MCP 設定サンプルのスニペットをコピーします。

ステップ 2：MCP サーバーをインストールする

~/.aws/amazonq/mcp.json にある Amazon Q Developer MCP クライアントの設定ファイルを開きます

オプション 1：npx を使用する（推奨）

サーバーを使用する最も簡単な方法は、インストール不要の npx を使用することです。

1. Amazon Q Developer MCP クライアントの設定ファイルに、次の設定を追加します。

{
  "mcpServers": {
    "promptz.dev": {
      "command": "npx",
      "args": ["-y", "@promptz/mcp"],
      "env": {
        "PROMPTZ_API_URL": "your-api-url-from-promptz.dev",
        "PROMPTZ_API_KEY": "your-api-key-from-promptz.dev"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

オプション 2：ローカルインストール

1. リポジトリをクローンします。

git clone https://github.com/cremich/promptz-mcp.git
cd promptz-mcp

2. 依存関係をインストールしてビルドします。

npm install
npm run build

3. MCP クライアントの設定ファイルに、次の設定を追加します。

{
  "mcpServers": {
    "promptz.dev": {
      "command": "node",
      "args": ["/path/to/promptz-mcp/build/index.js"],
      "env": {
        "PROMPTZ_API_URL": "your-api-url-from-promptz.dev",
        "PROMPTZ_API_KEY": "your-api-key-from-promptz.dev"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

トラブルシューティング

サーバーで問題が発生した場合は、次を確認してください。

1. API 認証情報が正しいことを確認します
2. MCP クライアントでサーバーが正しく設定されていることを確認します
3. ~/.promptz/logs/mcp-server.log にあるログでエラーメッセージを確認します
4. デバッグには MCP Inspector を使用します。

# Run with environment variables
PROMPTZ_API_URL="your-api-url" PROMPTZ_API_KEY="your-api-key" npm run inspector

Inspector は、ブラウザーでデバッグツールにアクセスするための URL を表示します。

開発

サーバーへの貢献や変更を希望する方は、次の手順を実行してください。

# Install dependencies
npm install

# Build the server
npm run build

# For development with auto-rebuild
npm run watch

# Run tests
npm test

セキュリティに関する考慮事項

• このサーバーはプロンプトへの読み取りアクセスのみを提供し、書き込み操作は実装していません
• API 認証情報は MCP クライアントの設定ファイルに保存されます
• promptz.dev API との通信はすべて HTTPS 経由で行われます
• サーバーはホームディレクトリのファイル（~/.promptz/logs/mcp-server.log）にログを記録します