系统提示代理服务器

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

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

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

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

所需客户端

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

Related MCP server: MCP-researcher Server

为什么要使用此服务器？

• 代理管理：使用自定义系统提示和工具配置创建和管理 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 。

相关链接

• 多模态 MCP 客户端- 语音驱动的 MCP 客户端

• systemprompt.io 文档