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.

系统提示代理服务器

网站|文档|博客|获取 API 密钥

专用的模型上下文协议 (MCP) 服务器，让您能够通过强大的提示和工具管理系统创建、管理和扩展 AI 代理。此服务器与systemprompt.io集成，可通过 MCP 无缝创建、管理和版本控制系统提示。

使用此服务器需要 API 密钥。目前 API 密钥免费，但未来可能会有所变更。您可以点击此处获取。

此服务器使用@modelcontextprotocol/sdk中的采样和通知功能。此功能仅适用于支持这些功能的高级客户端。您可以使用免费的开源客户端multimodal-mcp-client来提供完整的语音驱动 AI 工作流解决方案。

所需客户端

此服务器旨在与multimodal-mcp-client （一款提供前端界面的语音驱动 MCP 客户端）配合使用。请确保同时设置这两个组件才能使用完整功能。

为什么要使用此服务器？

代理管理：使用自定义系统提示和工具配置创建和管理 AI 代理
可扩展工具系统：通过 MCP 添加、修改和组合工具来增强代理的能力
提示管理：集中管理系统提示，并提供版本控制和元数据支持
类型安全集成：完全支持 TypeScript 并具有适当的错误处理
MCP 兼容性：与multimodal-mcp-client和其他 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 的实际运行情况：

▶️观看演示视频

演示展示了：

语音控制的人工智能交互
多模式输入处理
工具执行和工作流程自动化
实时语音合成

发展

安装依赖项：

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 来访问浏览器中的调试工具。

测试

该项目使用 Jest 进行测试，并支持 TypeScript 和 ESM（ECMAScript 模块）。

测试配置

测试设置包括：

通过 ESM 模块全面支持 TypeScript
全局获取模拟
运行之间自动重置测试
用于验证的自定义匹配器
类型安全的模拟实用程序

模块分辨率

该项目采用双模块解析策略：

源代码使用带有.js扩展名的 ESM（ECMAScript 模块）
测试使用 CommonJS 来与 Jest 兼容

这是通过两个 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