systemprompt-agent-server

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

一个专门的模型上下文协议（MCP）服务器，使您能够通过强大的提示和工具管理系统创建、管理和扩展AI代理。此服务器与systemprompt.io集成，以提供通过MCP无缝创建、管理和版本化系统提示的功能。

使用此服务器需要API密钥。目前是免费的，但未来可能会改变。您可以在这里获取一个API密钥。

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

所需客户端

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

为什么使用此服务器？

• 代理管理：使用自定义系统提示和工具配置创建和管理AI代理
• 可扩展工具系统：添加、修改和组合工具以增强代理的能力
• 提示管理：集中管理带有版本控制和元数据支持的系统提示
• 类型安全集成：完全支持TypeScript并具有适当的错误处理
• MCP兼容性：与multimodal-mcp-client和其他MCP兼容客户端无缝协作
• 开源：在MIT许可下免费使用和修改

功能

核心功能

• MCP协议集成：全面实现模型上下文协议，以实现无缝的AI代理交互
• 语音驱动界面：通过multimodal-mcp-client兼容语音命令
• 实时处理：支持流式响应和实时交互
• 类型安全实现：完全支持TypeScript并具有适当的错误处理

代理管理

• 使用特定能力创建和配置AI代理
• 管理代理状态和上下文
• 通过系统提示定义代理行为
• 监控和调试代理交互
• 代理配置的版本控制
• 代理资源的资源管理

高级工具系统

内置工具包括：

• 提示管理
  • create_prompt - 创建带有元数据的新系统提示
  • edit_prompt - 更新现有系统提示并进行版本控制
  • get_prompt - 检索特定提示配置
• 资源管理
  • create_resource - 创建新的代理资源和配置
  • edit_resource - 修改现有代理资源
  • list_resources - 浏览可用代理资源
• read_resource - 访问特定代理资源内容
• 系统工具
  • systemprompt_heartbeat - 监控系统状态和健康状况
  • systemprompt_fetch_resources - 检索所有可用资源
• 代理管理
  • create_agent - 创建新的systemprompt代理
  • edit_agent - 修改现有的systemprompt代理
  • list_agents - 查看可用的systemprompt代理

采样与通知

• 具有高级采样能力的AI响应
• 实时通知系统用于代理事件
• 可配置的采样参数
• 事件驱动的通知架构

集成功能

• API密钥管理和身份验证
• 用户状态和账单信息跟踪
• 订阅管理
• 使用监控和分析

开发工具

• 内置调试功能
• 测试实用程序和固定装置
• 类型安全模拟工具
• 综合测试框架

🎥 演示与展示

观看我们的视频演示，了解Systemprompt MCP客户端的实际操作：

▶️ 观看演示视频

演示展示了：

• 基于语音的AI交互
• 多模态输入处理
• 工具执行和工作流自动化
• 实时语音合成

开发

安装依赖项：

npm install

构建服务器：

npm run build

开发模式自动重建：

npm run watch

安装

通过Smithery安装

要通过Smithery自动安装SystemPrompt Agent for Claude Desktop：

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

Inspector将提供一个URL，以便在浏览器中访问调试工具。

测试

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

测试配置

测试设置包括：

• 完全支持TypeScript和ESM模块
• 全局fetch模拟
• 自动测试重置
• 自定义匹配器进行验证
• 类型安全模拟工具

模块解析

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

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

这是通过两个TypeScript配置设置的：

• tsconfig.json：源代码的主要配置（ESM）
• tsconfig.test.json：测试特定配置（CommonJS）

// 源代码导入（ESM）
import { Something } from "../path/to/module.js";

// 测试文件导入（CommonJS）
import { Something } from "../path/to/module";

运行测试

# 运行测试
npm test

# 监视模式
npm run test:watch

# 覆盖报告
npm run test:coverage

测试结构

测试位于它们所测试文件旁边的__tests__目录中。命名约定为*.test.ts。

相关链接

• Multimodal MCP Client - 基于语音的MCP客户端
• systemprompt.io 文档