local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

The server has integration with Discord for community support, as indicated by the Discord badge in the README.
The server uses Jest for testing with TypeScript and ESM support, including features like full TypeScript support, global fetch mocking, and custom matchers for validation.
The server is available as an npm package and displays its npm version badge, indicating integration with the npm package registry.

システムプロンプトエージェントサーバー

強力なプロンプトおよびツール管理システムを通じてAIエージェントの作成、管理、拡張を可能にする、専用のModel Context Protocol（MCP）サーバーです。このサーバーはsystemprompt.ioと統合されており、MCPを介してシステムプロンプトのシームレスな作成、管理、バージョン管理を実現します。

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

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

必要なクライアント

このサーバーは、フロントエンドインターフェースを提供する音声対応MCPクライアントであるマルチモーダルMCPクライアントと連携するように設計されています。すべての機能を使用するには、両方のコンポーネントを設定してください。

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

エージェント管理: カスタマイズされたシステムプロンプトとツール構成を使用して AI エージェントを作成および管理します
拡張可能なツールシステム:MCP を通じてツールを追加、変更、組み合わせてエージェントの能力を強化します。
プロンプト管理: バージョン管理とメタデータのサポートによるシステムプロンプトの集中管理
タイプセーフな統合: 適切なエラー処理を備えた完全な TypeScript サポート
MCP 互換性:マルチモーダル MCP クライアントおよびその他の MCP 互換クライアントとシームレスに動作します。
オープンソース: MITライセンスの下で自由に使用および改変可能

特徴

コア機能

MCPプロトコル統合：シームレスなAIエージェントインタラクションを実現するモデルコンテキストプロトコルの完全実装
音声駆動インターフェース: マルチモーダルMCPクライアントを介した音声コマンドと互換性があります
リアルタイム処理:ストリーミング応答とリアルタイムインタラクションをサポート
型安全な実装: 適切なエラー処理を備えた完全な TypeScript サポート

エージェント管理

特定の機能を持つ AI エージェントを作成および構成する
エージェントの状態とコンテキストを管理する
システムプロンプトを通じてエージェントの動作を定義する
エージェントのインタラクションの監視とデバッグ
エージェント構成のバージョン管理
エージェント資産のリソース管理

高度なツールシステム

組み込みツールには次のものが含まれます。

迅速な管理
- create_prompt - メタデータを使用して新しいシステムプロンプトを作成する
- edit_prompt - 既存のシステムプロンプトをバージョン管理で更新する
- get_prompt - 特定のプロンプト設定を取得する
リソース管理
- create_resource - 新しいエージェントリソースと構成を作成する
- edit_resource - 既存のエージェントリソースを変更する
- list_resources - 利用可能なエージェントリソースを参照する
- read_resource - 特定のエージェントリソースコンテンツにアクセスする
システムツール
- systemprompt_heartbeat - システムの状態と健全性を監視する
- systemprompt_fetch_resources - 利用可能なすべてのリソースを取得する
エージェント管理
- create_agent - 新しいシステムプロンプトエージェントを作成する
- edit_agent - 既存のシステムプロンプトエージェントを変更する
- list_agents - 利用可能なシステムプロンプトエージェントを表示する

サンプリングと通知

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

統合機能

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

開発ツール

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

🎥 デモとショーケース

Systemprompt MCP Client の動作を確認するには、ビデオデモをご覧ください。

▶️ デモビデオを見る

デモでは次の内容を紹介します:

音声制御AIインタラクション
マルチモーダル入力処理
ツール実行とワークフロー自動化
リアルタイム音声合成

発達

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

npm install

サーバーを構築します。

npm run build

自動リビルドを使用した開発の場合:

npm run watch

インストール

Smithery経由でインストール

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

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

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

テスト

このプロジェクトでは、TypeScript と ESM (ECMAScript モジュール) サポートを使用したテストに Jest を使用します。

テスト構成

テストのセットアップには以下が含まれます。

ESMモジュールによる完全なTypeScriptサポート
グローバルフェッチモック
実行間の自動テストリセット
検証用のカスタムマッチャー
型安全なモックユーティリティ

モジュール解像度

このプロジェクトでは、デュアルモジュール解決戦略を使用します。

ソースコードは.js拡張子のESM（ECMAScriptモジュール）を使用しています
テストでは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です。

SystemPrompt MCP Server