AI代理管理系统

一个基于Model Context Protocol (MCP)的AI代理管理系统,提供创建、管理和扩展AI代理的功能,包括提示管理、工具配置和版本控制。

  • by Ejb503
  • TypeScript
  • 本地部署
  • 16 星标
  • 更新于
在 GitHub 查看 Ejb503/systemprompt-mcp-core

使用说明

systemprompt代理服务器

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

一个专门的模型上下文协议(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.

相关链接