systemprompt-agent-server

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

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

使用此服务器需要 API 密钥。 目前是免费的，但将来可能会发生变化。 您可以在此处获取一个。

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

必需客户端

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

为什么使用此服务器？

• 代理管理：使用自定义系统提示和工具配置创建和管理 AI 代理
• 可扩展的工具系统：添加、修改和组合工具，以通过 MCP 增强代理的功能
• 提示管理：集中管理系统提示，支持版本控制和元数据
• 类型安全集成：完整的 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 Client 的实际应用：

▶️ 观看演示视频

演示展示了：

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

开发

安装依赖项：

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

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 文档