使用说明
systemprompt代理服务器
一个专门的模型上下文协议(MCP)服务器,使您能够通过强大的提示和工具管理系统创建、管理和扩展AI代理。此服务器与 系统提示.io 通过MCP提供系统提示的无缝创建、管理和版本控制。
使用此服务器需要API密钥。目前这是免费的,但将来可能会改变。你可以买一个 这里.
此服务器使用来自的采样和通知功能 @模型上下文协议/sdk。这仅适用于支持这些功能的高级客户端。免费开源客户端 多模式mcp客户端 可用于提供完整的语音驱动AI工作流解决方案。
所需客户
此服务器旨在与 多模式mcp客户端 -提供前端接口的语音供电MCP客户端。请确保为完整功能设置了这两个组件。
为什么要使用此服务器?
- 代理管理:使用定制的系统提示和工具配置创建和管理AI代理
- 可扩展工具系统:添加、修改和组合工具,通过MCP增强代理的能力
- 及时管理:通过版本控制和元数据支持对系统提示进行集中管理
- 类型安全集成:完全支持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-创建新的systemprompt代理edit_agent-修改现有的systemprompt代理list_agents-查看可用的systemprompt代理
取样和通知
- 人工智能响应的高级采样功能
- 代理事件实时通知系统
- 可配置的采样参数
- 事件驱动的通知架构
集成功能
- API密钥管理和认证
- 用户状态和账单信息跟踪
- 订阅管理
- 使用监控和分析
开发工具
- 内置调试功能
- 测试工具和夹具
- 类型安全模拟实用程序
- 全面的测试框架
🎥 演示与展示
观看我们的视频演示,了解Systemprompt MCP客户端的运行情况:
演示展示了:
- 语音控制的人工智能交互
- 多模态输入处理
- 工具执行和工作流自动化
- 实时语音合成
发展
安装依赖项:
npm install
构建服务器:
npm run build
对于自动重建的开发:
npm run watch
安装
通过Smithery安装
通过以下方式自动安装克劳德桌面的SystemPrompt代理 史密瑟里:
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检查员,可作为包脚本使用:
npm run inspector
检查器将提供一个URL,用于访问浏览器中的调试工具。
测试
该项目使用Jest进行测试,支持TypeScript和ESM(ECMAScript模块)。
测试配置
测试设置包括:
- ESM模块完全支持TypeScript
- 全球获取嘲讽
- 运行之间自动重置测试
- 用于验证的自定义匹配器
- 类型安全模拟实用程序
模组分辨率
该项目采用双模块解析策略:
- 源代码使用ESM(ECMAScript模块)
.js扩展 - 测试使用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文档
