快速接入

先看主来源和安装命令，再打开仓库或文档；下面只保留这个条目的关键接入事实。

命令预览

docker run -p 8080:8080 serenity-mcp:1.4.2

详细介绍

Serenity Star MCP服务器

![License](LICENSE) ![.NET](https://dotnet.microsoft.com/) ![MCP](https://modelcontextprotocol.io/) ](https://github.com/lharillo/serenity-mcp/releases)

模型上下文协议（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=`	向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=

列表工具测试

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许可证-请参阅许可证文件以获取详细信息。

🤝 贡献

欢迎投稿！拜托：

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

看贡献.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工具）

目录标签

C#ClaudeAI代理AI代理管理混合部署数据集管理知识库管理会话处理嵌入生成

支持客户端

Claude DesktopClaudeVS Code

接入字段

传输方式（transport，传输协议）

stdio

鉴权方式（authType，认证方式）

api-key

运行时（runtime，运行环境）

Docker

工具数量（toolCount，工具数）

75

资源数量（resourceCount，资源数）

0

提示词数量（promptCount，提示词数）

0

权限和风险

stdioapi-key部署方式未说明

接入前请确认传输方式、认证方式和部署位置，并根据实际工具能力限制访问范围。

安装前确认

不要直接授予不必要的文件、网络或账号权限；先核对安装命令和配置内容。

来源信息

MCP World

mcpworld.com

/detail/d774ae57ce9dd48f50d8426cfa36f125

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

继续浏览同类 MCP

更多AI代理 MCP（18,706）返回 MCP 目录

上一个 MCP

Serena Slim

Serena-slim是一个针对AI助手的MCP服务器优化工具，通过智能分组减少50.3%的上下文窗口令牌使用，同时保留所有功能，兼容Claude、ChatGPT、Gemini等MCP客户端。

下一个 MCP

Sergehuber Inoyu MCP Unomi Server

全面解析Sergehuber Inoyu MCP Unomi ServerMCP Server的核心功能、安装配置和实用案例。作为顶级Model Context Protocol服务器，Sergehuber Inoyu MCP Unomi Server能让AI助手访问实时数据、执行操作，为您提供更智能的工作体验和自动化解决方案。

Serenity MCP