시스템 프롬프트-에이전트-서버

웹사이트 | 문서 | 블로그 | API 키 받기

강력한 프롬프트 및 도구 관리 시스템을 통해 AI 에이전트를 생성, 관리 및 확장할 수 있는 특수 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 systemprompt.io 와 통합되어 MCP를 통해 시스템 프롬프트를 원활하게 생성, 관리 및 버전 관리할 수 있도록 지원합니다.

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

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

필수 클라이언트

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

Related MCP server: MCP-researcher Server

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

• 에이전트 관리 : 사용자 정의 시스템 프롬프트 및 도구 구성을 사용하여 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 입니다.

관련 링크

• 멀티모달 MCP 클라이언트 - 음성 기반 MCP 클라이언트

• systemprompt.io 문서