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 에이전트를 생성, 관리 및 확장할 수 있는 특수 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 systemprompt.io 와 통합되어 MCP를 통해 시스템 프롬프트를 원활하게 생성, 관리 및 버전 관리할 수 있도록 지원합니다.

이 서버를 사용하려면 API 키가 필요합니다. 현재 무료이지만 향후 변경될 수 있습니다. 여기에서 API 키를 받으실 수 있습니다.

이 서버는 @modelcontextprotocol/sdk 의 샘플링 및 알림 기능을 사용합니다. 이 기능은 이러한 기능을 지원하는 고급 클라이언트에서만 작동합니다. 무료 오픈소스 클라이언트인 multimodal-mcp-client를 사용하면 완전한 음성 기반 AI 워크플로 솔루션을 제공할 수 있습니다.

필수 클라이언트

이 서버는 프런트엔드 인터페이스를 제공하는 음성 기반 MCP 클라이언트인 멀티모달 MCP 클라이언트와 함께 작동하도록 설계되었습니다. 모든 기능을 사용하려면 두 구성 요소를 모두 설정해야 합니다.

왜 이 서버를 사용해야 하나요?

에이전트 관리 : 사용자 정의 시스템 프롬프트 및 도구 구성을 사용하여 AI 에이전트를 생성하고 관리합니다.
확장 가능한 도구 시스템 : MCP를 통해 도구를 추가, 수정 및 결합하여 에이전트의 역량을 향상시킵니다.
프롬프트 관리 : 버전 관리 및 메타데이터 지원을 통한 시스템 프롬프트의 중앙 관리
Type-Safe 통합 : 적절한 오류 처리를 통한 전체 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 클라이언트가 실제로 작동하는 모습을 보려면 비디오 데모를 시청하세요.

▶️ 데모 영상 보기

데모에서는 다음이 표시됩니다.

음성 제어 AI 상호작용
다중 모드 입력 처리
도구 실행 및 워크플로 자동화
실시간 음성 합성

개발

종속성 설치:

지엑스피1

서버를 빌드하세요:

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를 사용합니다.

이는 두 가지 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