promptz.dev MCP サーバー

AI アシスタントから直接 promptz.dev のプロンプトにアクセスします。

この MCP サーバーを使用すると、コピーアンドペーストせずに promptz.dev API からプロンプトにアクセスできるため、開発ワークフローでのコンテキストの切り替えと摩擦が軽減されます。

特徴

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

ツール- AIアシスタントがpromptz.dev APIと対話できるようにする実行可能関数
プロンプト- MCP プロンプトテンプレートとしてプロンプトに直接アクセスします

ツールとプロンプト API

ツール

サーバーは、MCP プロトコルを通じて次のツールを公開します。

`list_prompts`

promptz.dev プラットフォームから利用可能なプロンプトを一覧表示します。

入力スキーマ:

{
  "type": "object",
  "properties": {
    "cursor": {
      "type": "string",
      "description": "Pagination token for fetching the next set of results"
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Filter prompts by tags (e.g. ['CLI', 'JavaScript'])"
    }
  }
}

使用例:

// List all prompts
list_prompts()

// List prompts with pagination
list_prompts({ "cursor": "next-page-token" })

// Filter prompts by tags
list_prompts({ "tags": ["JavaScript", "CLI"] })

応答形式:

{
  "prompts": [
    {
      "name": "React Component Generator",
      "description": "Generates React components based on specifications",
      "tags": ["React", "JavaScript", "Frontend"]
    }
    // More prompts...
  ],
  "nextCursor": "optional-pagination-token"
}

`get_prompt`

名前で特定のプロンプトを取得します。

入力スキーマ:

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Name of the prompt to retrieve"
    }
  },
  "required": ["name"]
}

使用例:

get_prompt({ "name": "React Component Generator" })

応答形式:

{
  "name": "React Component Generator",
  "description": "Generates React components based on specifications",
  "instruction": "Create a React component that...",
  "tags": ["React", "JavaScript", "Frontend"]
}

プロンプトAPI

サーバーは MCP プロンプト機能も実装しており、これにより AI アシスタントはテンプレートとしてプロンプトに直接アクセスできるようになります。

プロンプトの一覧: 利用可能なプロンプトをMCPプロンプトテンプレート形式で返します
プロンプトを取得: AIアシスタントが直接使用できるMCPプロンプトテンプレートとして特定のプロンプトを返します。

インストール

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

https://promptz.dev/mcpに移動します。
API キー、API URL、サンプル MCP 構成スニペットなどの MCP 設定をコピーします。

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

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

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

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: ローカルインストール

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

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

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

npm install
npm run build

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": []
    }
  }
}

ステップ3: MCPクライアントを構成する

クロードデスクトップ

Claude Desktop 構成ファイルにサーバー構成を追加します。

MacOS : ~/Library/Application Support/Claude/claude_desktop_config.json
Windows : %APPDATA%/Claude/claude_desktop_config.json

ファイルが存在しない場合は、次の内容で作成します。

{
  "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": []
    }
  }
}

その他のMCPクライアント

その他の MCP クライアントについては、MCP サーバーの構成方法については、それぞれのドキュメントを参照してください。

トラブルシューティング

サーバーに問題が発生した場合:

API認証情報が正しいことを確認してください
MCPクライアントでサーバーが適切に設定されていることを確認します
ログ内のエラーメッセージを探す
デバッグには MCP インスペクタを使用します。

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

インスペクターは、ブラウザでデバッグツールにアクセスするための URL を提供します。

発達

サーバーに貢献したり修正したりしたい人:

# Install dependencies
npm install

# Build the server
npm run build

# For development with auto-rebuild
npm run watch

# Run tests
npm test

使用例

サーバーが MCP クライアントに接続されると、自然言語で使用できるようになります。

「promptz.dev から利用可能なプロンプトを一覧表示する」
「JavaScript に関する CLI プロンプトを検索する」
「『React コンポーネントドキュメント』というプロンプトを表示してください」
「React コンポーネントドキュメントプロンプトを使用してドキュメントを改善します」

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

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

promptz.dev MCP Server

Integrations