systemprompt-agent-server

systemprompt-agent-server

ウェブサイト | ドキュメント | ブログ | API キーを取得

強力なプロンプトおよびツール管理システムを通じて、AI エージェントの作成、管理、拡張を可能にする、特化型の Model Context Protocol（MCP）サーバーです。このサーバーは systemprompt.io と連携し、MCP を通じてシステムプロンプトをシームレスに作成、管理、バージョン管理できます。

このサーバーを使用するには API KEY が必要です。現在は無料ですが、将来的に変更される可能性があります。こちらから取得できます。

このサーバーは、@modelcontextprotocol/sdk のサンプリング機能と通知機能を使用します。これらの機能をサポートする高度なクライアントでのみ動作します。無料のオープンソースクライアント multimodal-mcp-client を使用すると、音声を活用した完全な AI ワークフローソリューションを実現できます。

必須クライアント

このサーバーは、フロントエンドインターフェースを提供する音声対応 MCP クライアント multimodal-mcp-client と連携するよう設計されています。すべての機能を利用するには、両方のコンポーネントをセットアップしてください。

このサーバーを使用する理由

• エージェント管理：カスタマイズしたシステムプロンプトとツール設定を使って AI エージェントを作成、管理できます
• 拡張可能なツールシステム：MCP を通じてツールを追加、変更、組み合わせ、エージェントの能力を強化できます
• プロンプト管理：バージョン管理とメタデータに対応した、システムプロンプトの一元管理
• 型安全な連携：適切なエラー処理を備えた、完全な TypeScript サポート
• MCP 互換性：multimodal-mcp-client やその他の MCP 互換クライアントとシームレスに動作します
• オープンソース：MIT ライセンスのもとで無料で使用、変更できます

機能

コア機能

• MCP プロトコル連携：シームレスな AI エージェントとのやり取りを実現する Model Context Protocol の完全な実装
• 音声対応インターフェース：multimodal-mcp-client を通じた音声コマンドに対応
• リアルタイム処理：ストリーミング応答とリアルタイムのやり取りに対応
• 型安全な実装：適切なエラー処理を備えた、完全な TypeScript サポート

エージェント管理

• 特定の能力を備えた AI エージェントを作成、設定します
• エージェントの状態とコンテキストを管理します
• システムプロンプトを通じてエージェントの動作を定義します
• エージェントとのやり取りを監視、デバッグします
• エージェント設定のバージョン管理
• エージェントのアセットに関するリソース管理

高度なツールシステム

組み込みツールには以下が含まれます。

• プロンプト管理
  • create_prompt - メタデータ付きで新しいシステムプロンプトを作成します
  • edit_prompt - バージョン管理を行いながら既存のシステムプロンプトを更新します
  • get_prompt - 特定のプロンプト設定を取得します
• リソース管理
  • create_resource - 新しいエージェントのリソースと設定を作成します
  • edit_resource - 既存のエージェントのリソースを変更します
  • list_resources - 利用可能なエージェントのリソースを一覧表示します
  • read_resource - 特定のエージェントのリソース内容にアクセスします
• システムツール
  • systemprompt_heartbeat - システムのステータスと稼働状態を監視します
  • systemprompt_fetch_resources - 利用可能なすべてのリソースを取得します
• エージェント管理
  • create_agent - 新しいsystempromptエージェントを作成します
  • edit_agent - 既存のsystempromptエージェントを変更します
  • list_agents - 利用可能なsystempromptエージェントを表示します

サンプリングと通知

• AI の応答に対する高度なサンプリング機能
• エージェントのイベントをリアルタイムで通知するシステム
• 設定可能なサンプリングパラメーター
• 通知のためのイベント駆動型アーキテクチャ

統合機能

• API キーの管理と認証
• ユーザーのステータスと請求情報の追跡
• サブスクリプション管理
• 利用状況の監視と分析

開発ツール

• 組み込みのデバッグ機能
• テストユーティリティとフィクスチャ
• 型安全なモックユーティリティ
• 包括的なテストフレームワーク

🎥 デモと紹介

Systemprompt MCP Client の動作を紹介する動画をご覧ください。

▶️ デモ動画を見る

デモでは、以下を紹介しています。

• 音声で制御する AI とのやり取り
• マルチモーダル入力の処理
• ツールの実行とワークフローの自動化
• リアルタイムの音声合成

開発

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

npm install

サーバーをビルドします。

npm run build

自動再ビルドを有効にして開発する場合：

npm run watch

インストール

Smithery 経由でのインストール

Smithery 経由でSystemPrompt AgentをClaude Desktopに自動インストールするには：

npx -y @smithery/cli install systemprompt-agent-server --client claude

手動インストール

Claude Desktopを手動で設定するには、サーバー設定を追加します。

MacOSの場合：~/Library/Application Support/Claude/claude_desktop_config.json Windowsの場合：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "systemprompt-agent-server": {
      "command": "/path/to/systemprompt-agent-server/build/index.js"
    }
  }
}

デバッグ

MCP サーバーはstdio経由で通信するため、デバッグは難しい場合があります。パッケージスクリプトとして利用できるMCP Inspectorの使用をおすすめします。

npm run inspector

Inspectorから、ブラウザーでデバッグツールにアクセスするためのURLが表示されます。

テスト

このプロジェクトでは、TypeScriptとESM（ECMAScript Modules）をサポートするJestを使用してテストを実行します。

テストの設定

テスト環境には以下が含まれます。

• ESMモジュールを含む、TypeScriptの完全なサポート
• グローバルなfetchのモック
• テスト実行間の自動リセット
• 検証用のカスタムマッチャー
• 型安全なモックユーティリティ

モジュール解決

このプロジェクトでは、2種類のモジュール解決方式を使用します。

• ソースコードでは、.js拡張子を使用するESM（ECMAScript Modules）を使用します
• Jestとの互換性を保つため、テストではCommonJSを使用します

以下の2つのTypeScript設定で構成されています。

• tsconfig.json：ソースコード用のメイン設定（ESM）
• tsconfig.test.json：テスト専用の設定（CommonJS）

// Source code imports (ESM)
import { Something } from "../path/to/module.js";

// Test file imports (CommonJS)
import { Something } from "../path/to/module";

テストの実行

# Run tests
npm test

# Watch mode
npm run test:watch

# Coverage report
npm run test:coverage

テスト構成

テスト対象のファイルと同じ場所にある__tests__ディレクトリにテストが配置されています。ファイル名には*.test.tsという命名規則を使用します。

関連リンク

• マルチモーダルMCPクライアント - 音声で操作するMCPクライアント
• systemprompt.ioのドキュメント