AI导哈

AI代理管理服务器

Serenity Star MCP Server是一个提供75种工具的AI代理管理服务器，支持AI代理管理、数据集、知识库、嵌入、转录和会话处理，适用于AI平台集成和开发。

  • by lharillo
  • C#
  • 混合部署
  • 更新于
在 GitHub 查看 lharillo/serenity-mcp

使用说明

Serenity Star MCP服务器

模型上下文协议（MCP）服务器 Serenity Star人工智能平台，提供 75工具 随着 API覆盖率100% 用于通过HTTP/SSE传输进行AI代理管理、数据集、知识、嵌入、转录和对话处理。

🚀 快速开始

VS代码设置（推荐）

使用 HTTP流式传输 （现代MCP传输）以获得最佳性能：

{
  "servers": {
    "serenity-star": {
      "type": "http",
      "url": "https://your-mcp-server.example.com/",
      "headers": {
        "X-Serenity-API-Key": "YOUR_API_KEY_HERE"
      }
    }
  }
}

替换：

  • your-mcp-server.example.com 使用您的MCP服务器URL
  • YOUR_API_KEY_HERE 使用您的Serenity Star API密钥

注： 尾随 / URL中的URL很重要，它指向提供HTTP Streamable的根端点。

👉 详见 VS代码设置指南 有关分步说明、故障排除和替代配置（包括传统SSE传输）。

Claude桌面配置

Claude Desktop目前需要 mcp-remote 远程服务器的代理：

{
  "mcpServers": {
    "serenity-star": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://your-mcp-server.example.com/",
        "--header",
        "X-Serenity-API-Key: YOUR_API_KEY_HERE"
      ]
    }
  }
}

重要提示： 您的Serenity Star API密钥必须通过 X-Serenity-API-Key 头球服务器不存储任何凭据。

本地开发

# Clone repository
git clone https://github.com/lharillo/serenity-mcp.git
cd serenity-mcp

# Build and run
dotnet build
dotnet run

# Server starts on http://localhost:8080

📡 API终点

服务器同时支持这两种功能 上海证券交易所 和 HTTP流式传输 运输：

苏格兰和南方能源公司运输

方法 端点 描述
GET /sse MCP协议的服务器发送事件
POST /message?sessionId=<id> 向MCP服务器发送消息

HTTP流传输

方法 端点 描述
POST / 发送JSON-RPC请求（初始化、工具等）

公用设施端点

方法 端点 描述
GET /health 健康检查（返回状态、时间戳、版本）
GET /docs 交互式文档

注： 服务器自动处理这两种传输。VS代码 "type": "http" 或 "type": "sse" 将使用适当的端点。

🛠️ 可用工具（共75个）

代理管理（33个工具）

5种代理类型-完整CRUD

每种代理类型都支持CREATE、UPDATE和UPDATE+PUBLISH操作：

助理代理（3个工具）：

  • CreateAssistantAgent -创建通用会话代理
  • UpdateAssistantAgent -更新而不发布
  • UpdateAssistantAgentWithVersion -使用版本控制进行更新

活动代理（3个工具）：

  • CreateActivityAgent -创建工作流自动化代理
  • UpdateActivityAgent -更新而不发布
  • UpdateActivityAgentWithVersion -使用版本控制进行更新

复制品代理（3个工具）：

  • CreateCopilotAgent -创建具有实时建议的交互式助手
  • UpdateCopilotAgent -更新而不发布
  • UpdateCopilotAgentWithVersion -使用版本控制进行更新

聊天代理（3个工具）：

  • CreateChatAgent -创建聊天完成代理
  • UpdateChatAgent -更新而不发布
  • UpdateChatAgentWithVersion -使用版本控制进行更新

AI代理（3个工具）：

  • CreateAIProxyAgent -创建直接模型访问代理（无需处理）
  • UpdateAIProxyAgent -更新而不发布
  • UpdateAIProxyAgentWithVersion -使用版本控制进行更新

版本管理（8个工具）

  • ListAgentVersions -列出代理的所有版本
  • GetCurrentAgentVersion -获取当前草稿版本
  • GetPublishedAgentVersion -获取已发布版本
  • GetAgentVersionByNumber -按编号获取特定版本
  • CreateAgentDraft -创建新的草稿版本
  • CreateAgentDraftFromVersion -从现有版本创建草稿
  • SaveDraftVersion -将更改保存到草稿
  • PublishAgentVersion -发布草稿版本

基本操作（8个工具）

  • ListAgents -按页码列出所有可用代理
  • GetAgentDetails -获取特定代理的详细信息
  • ExecuteAgent -执行代理（支持chatId的无状态和有状态）
  • CreateConversation -创建有状态的对话
  • CreateConversationInfo -使用上下文变量创建对话信息
  • GetConversationInfoByVersion -获取特定版本的对话信息
  • GetConversation -获取对话详细信息和历史记录
  • GetTokenUsage -获取用于计费的令牌使用统计信息

反馈（2个工具）

  • SubmitFeedback -提交RLHF反馈以获取代理响应
  • DeleteFeedback -删除以前提交的反馈

实例管理（1个工具）

  • ListAgentInstances -列出所有要监视的代理实例

数据集管理（11个工具）

数据集操作（6个工具）

  • ListDatasets -列出所有带分页的数据集
  • CreateDataset -创建新数据集
  • GetDataset -获取数据集详细信息
  • UpdateDataset -更新数据集元数据
  • DeleteDataset -删除数据集
  • QueryDataset -使用筛选器查询数据集

表操作（5个工具）

  • CreateTable -在数据集中创建表
  • UpdateTable -更新表架构/元数据
  • DeleteTable -删除表格
  • AppendToTable -将行追加到表中
  • ReplaceTableData -替换所有表数据

知识管理（7种工具）

永久知识（3个工具）

  • UploadKnowledgeFile -上传永久性知识文件
  • UploadKnowledgeFileForAgent -上传特定代理的知识
  • DeleteKnowledgeFile -删除知识文件

易变知识（4个工具）

  • UploadVolatileKnowledge -上传临时知识（base64编码）
  • UploadVolatileKnowledgeFromUrl -从URL上传临时知识
  • GetVolatileKnowledgeById -获取易变的知识细节
  • DeleteVolatileKnowledge -删除易变知识

会话管理（5个工具）

上下文管理（3个工具）

  • GetContextList -列出代理的上下文变量
  • GetContextByVersion -获取特定代理版本的上下文
  • GetConversationContext -获取特定对话的上下文

变量更新（2个工具）

  • UpdateContextVariables -更新对话上下文变量
  • DeleteConversation -删除对话及其历史记录

高级功能（9个工具）

嵌入（1个工具）

  • GenerateEmbeddings -生成用于语义搜索的文本嵌入

转录（2个工具）

  • TranscribeAudioFile -转录音频/视频文件
  • TranscribeAudioByFileId -按文件ID转录

文件管理（3个工具）

  • UploadFile -上传文件并获取文件ID
  • GetFileInfo -获取文件元数据
  • DownloadFile -下载文件（返回base64）

模型（1个工具）

  • ListModels -列出所有具有UUID的可用AI模型（对于创建代理至关重要）

分析（2个工具）

  • GetInsightsByAgent -获取代理的分析
  • GetInsightsByVersion -获取特定版本的分析

平台管理（10个工具）

账户管理（4个工具）

  • GetCurrentUser -获取当前用户信息
  • LoginUser -登录并获取身份验证令牌
  • LogoutUser -注销当前用户
  • RefreshToken -刷新身份验证令牌

验证（2个工具）

  • ValidateDatasetSchema -上传前验证数据集文件架构
  • ValidateTableSchema -上传前验证表文件架构

次级租户（1个工具）

  • ListSubtenants -按页码列出所有子租约

通道配置（1个工具）

  • GetChannelConfig -获取代理的通道配置

Agent Insights（2个工具）

  • GetInsightsByAgentInstance -获取代理实例的分析
  • GetInsightsByVersion -获取版本分析（上面列出了副本）

📊 覆盖率统计

类别 工具 状态
代理管理 33 ✅ 100%
数据集管理 11 ✅ 100%
知识管理 7 ✅ 100%
对话管理 5 ✅ 100%
高级功能 9 ✅ 100%
平台管理 10 ✅ 100%
总计 75 ✅ 100%

🔐 安全模型

服务器端未存储凭据：

  • API密钥由MCP客户端通过HTTP头提供
  • 每个请求包括 X-Serenity-API-Key 头球
  • 服务器充当Serenity Star API的透明代理

最佳实践：

  • 将API密钥存储在MCP客户端配置中
  • 永远不要将API密钥提交到版本控制
  • 定期旋转API键
  • 使用环境变量或安全保管库进行密钥管理

🏗️ 建筑

MCP Client (VS Code, Claude Desktop, etc.)
  ↓
  Headers: X-Serenity-API-Key
  ↓
MCP Server (this)
  ↓
  Forward API key + request
  ↓
Serenity Star API (https://api.serenitystar.ai)

技术栈：

  • NET 10.0与ASP。NET核心
  • 微软MCP官方SDK(ModelContextProtocol.AspNetCore v0.7.0）
  • HTTP/SSE传输（兼容Kubernetes）
  • 无状态架构（未存储会话状态）
  • Docker容器化部署

📋 配置

基本URL

Serenity Star API基本URL可以在中配置 appsettings.json:

{
  "SerenityApi": {
    "BaseUrl": "https://api.serenitystar.ai"
  }
}

违约： https://api.serenitystar.ai

环境变量

  • ASPNETCORE_URLS -服务器绑定URL（默认值： http://+:8080)
  • SerenityApi__BaseUrl -Serenity API基础URL覆盖

注： API键未配置为环境变量。它们必须来自客户端标头。

🧪 测试

健康检查

curl https://your-mcp-server.example.com/health

预期响应：

{
  "status": "healthy",
  "timestamp": "2026-01-30T05:52:00.000Z",
  "version": "1.4.2"
}

SSE连接测试

curl -N -H "Accept: text/event-stream" \
     -H "X-Serenity-API-Key: YOUR_KEY" \
     https://your-mcp-server.example.com/sse

预期响应：

event: endpoint
data: /message?sessionId=<unique-session-id>

列表工具测试

curl -X POST https://your-mcp-server.example.com/ \
  -H "Content-Type: application/json" \
  -H "Mcp-Session-Id: test-session" \
  -H "X-Serenity-API-Key: YOUR_KEY" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

🔧 发展

项目结构

serenity-mcp/
├── Services/
│   └── SerenityApiClient.cs       # HTTP client for Serenity API (75+ methods)
├── Tools/
│   ├── AccountTools.cs             # Account management (4 tools)
│   ├── AgentInstanceTools.cs       # Instance management (1 tool)
│   ├── AgentTools.cs               # Agent CRUD (13 tools)
│   ├── AgentVersionTools.cs        # Version management (8 tools)
│   ├── ChannelTools.cs             # Channel config (1 tool)
│   ├── ConversationTools.cs        # Conversation management (4 tools)
│   ├── DatasetTools.cs             # Dataset operations (11 tools)
│   ├── EmbeddingsTools.cs          # Embeddings (1 tool)
│   ├── FileTools.cs                # File management (3 tools)
│   ├── InsightsTools.cs            # Analytics (3 tools)
│   ├── KnowledgeTools.cs           # Knowledge management (3 tools)
│   ├── ModelTools.cs               # Model discovery (1 tool)
│   ├── MultiAgentTools.cs          # Multi-agent types (12 tools)
│   ├── SubtenantTools.cs           # Subtenant management (1 tool)
│   ├── TranscriptionTools.cs       # Transcription (2 tools)
│   ├── ValidationTools.cs          # Schema validation (2 tools)
│   └── VolatileKnowledgeTools.cs   # Volatile knowledge (4 tools)
├── Models/                         # Data models and DTOs
├── wwwroot/                        # Static landing page
├── Program.cs                      # Application entry point
├── Version.cs                      # Version information
└── SerenityStarMcp.csproj          # Project configuration

建筑

# Restore dependencies
dotnet restore

# Build project
dotnet build

# Run locally
dotnet run

# Build for production
dotnet publish -c Release

运行测试

# Run test suite
cd tests
./test-comprehensive.sh

🚢 部署

码头工人

# Build image
docker build -t serenity-mcp:1.4.2 .

# Run container
docker run -p 8080:8080 serenity-mcp:1.4.2

Docker Hub： lharillo/serenity-mcp:1.4.2

Kubernetes

部署清单示例：

apiVersion: apps/v1
kind: Deployment
metadata:
  name: serenity-mcp
  namespace: default
spec:
  replicas: 1
  selector:
    matchLabels:
      app: serenity-mcp
  template:
    metadata:
      labels:
        app: serenity-mcp
    spec:
      containers:
      - name: serenity-mcp
        image: lharillo/serenity-mcp:1.4.2
        ports:
        - containerPort: 8080
          name: http
        env:
        - name: ASPNETCORE_URLS
          value: "http://+:8080"
        livenessProbe:
          httpGet:
            path: /health
            port: 8080
          initialDelaySeconds: 10
          periodSeconds: 30
        readinessProbe:
          httpGet:
            path: /health
            port: 8080
          initialDelaySeconds: 5
          periodSeconds: 10
        resources:
          requests:
            memory: "256Mi"
            cpu: "250m"
          limits:
            memory: "512Mi"
            cpu: "500m"
---
apiVersion: v1
kind: Service
metadata:
  name: serenity-mcp
  namespace: default
spec:
  selector:
    app: serenity-mcp
  ports:
  - port: 8080
    targetPort: 8080
    name: http
  type: ClusterIP

看 k8s/ 完整Kubernetes清单的目录。

📚 文档

  • MCP协议： https://modelcontextprotocol.io
  • 宁静之星API： https://docs.serenitystar.ai
  • 微软。NET MCP SDK： https://github.com/modelcontextprotocol/csharp-sdk
  • VS代码设置指南： VSCODE_SETUP.md
  • API限制： API_限制.md
  • 实施计划： 实施_计划.md
  • 变更日志： 更改日志.md

📝 更新日志

看 更改日志.md 查看详细的版本历史。

📄 许可证

MIT许可证-请参阅 许可证 文件以获取详细信息。

🤝 贡献

欢迎投稿！拜托：

  1. 分叉存储库
  2. 创建要素分支(git checkout -b feature/amazing-feature)
  3. 提交您的更改(git commit -m 'Add amazing feature')
  4. 推到分支(git push origin feature/amazing-feature)
  5. 打开拉取请求

看 贡献.md 详细指南。

📞 支持

  • 文档： https://docs.serenitystar.ai
  • 问题： https://github.com/lharillo/serenity-mcp/issues
  • 讨论： https://github.com/lharillo/serenity-mcp/discussions
  • 网站： https://subgen.ai

🔗 链接

  • GitHub存储库： https://github.com/lharillo/serenity-mcp
  • Docker Hub： https://hub.docker.com/r/lharillo/serenity-mcp
  • 发布： https://github.com/lharillo/serenity-mcp/releases
  • 宁静之星平台： https://serenitystar.ai

建于❤️ 通过 人工智能 Subgen AI

版本： 1.4.2 | 状态： 生产就绪✅ | 新闻报道： 100%（75/75工具）

相关 MCP