使用说明

项目简介

Cognisphere ADK (Agent Development Kit) 是一个基于Google ADK构建的AI Agent开发框架，它不仅是一个AI Agent，更是一个能作为 MCP服务器 的认知架构平台。Cognisphere ADK 专注于提供结构化的上下文管理和功能扩展，通过集成 Model Context Protocol (MCP)，使得AI应用能够以标准化的方式与外部资源和工具进行交互。

主要功能点

资源管理 (通过MCP集成): 虽然Cognisphere ADK本身可能不直接托管“资源”，但它作为MCP服务器，能够连接和管理外部MCP服务器提供的资源，间接实现资源访问能力。
工具注册与执行 (通过MCP集成): Cognisphere ADK 能够注册和执行外部MCP服务器提供的工具，允许LLM客户端通过标准MCP协议调用这些工具，扩展Agent的功能。
Prompt 模板 (通过MCP集成): 虽然仓库中没有明确提及Prompt模板，但作为MCP服务器，理论上可以通过集成支持Prompt模板的管理和渲染，以实现定制化的LLM交互模式。
会话管理: 基于Google ADK的会话服务，Cognisphere ADK 具备完善的会话管理能力，能够跟踪用户交互状态。
能力声明: Cognisphere ADK 通过集成的MCP Toolset，可以声明其提供的工具和服务能力，供MCP客户端发现和使用。
多种传输协议支持: 虽然代码中主要体现的是基于Flask的Web UI和API，但理论上可以通过扩展支持 Stdio, SSE, WebSocket 等多种MCP传输协议。
Web UI 管理界面: 提供基于Flask的Web界面，用于配置和管理MCP服务器连接，以及与Agent进行交互。

安装步骤

克隆仓库:

git clone https://github.com/IhateCreatingUserNames2/cognisphere-adk.git
cd cognisphere-adk

安装依赖:

pip install -r requirements.txt

配置 OpenRouter API 密钥: 获取 OpenRouter API 密钥并设置环境变量。
```
export OPENROUTER_API_KEY=YOUR_OPENROUTER_API_KEY
```
或者，你也可以在 '.env' 文件中配置，项目根目录下已经提供了一个 '.env' 示例文件 'cognisphere_adk/config.py'，复制并修改即可。
运行服务器:
```
python app.py
```
服务器默认会在 'http://127.0.0.1:8091' 启动。

服务器配置 (MCP 客户端配置示例)

以下是一个 MCP 客户端连接 Cognisphere ADK 服务器的配置示例，假设 Cognisphere ADK 运行在 'http://your-cognisphere-server:8091'。

由于 Cognisphere ADK 本身作为 MCP 服务器的功能主要是通过 集成和桥接外部 MCP 服务器 来实现的，它本身可能不直接提供开箱即用的 Resources, Tools 或 Prompts 供客户端直接连接。

因此，更典型的使用场景是：

运行 Cognisphere ADK 服务器 (如上安装步骤)
在 Cognisphere ADK 的 Web UI 界面中配置和连接外部 MCP 服务器 (例如，文件系统服务器、数据库服务器等，参考 Web UI 的 "MCP Integration" 部分)。
MCP 客户端连接 Cognisphere ADK 服务器，并通过 Cognisphere ADK 间接访问和使用外部 MCP 服务器提供的资源和工具。

假设你要连接到 Cognisphere ADK 服务器，并希望通过它来访问一个文件系统 MCP 服务器，你需要在 Cognisphere ADK 的 Web UI 中配置该文件系统服务器。

在 MCP 客户端中，你可能需要配置连接到 Cognisphere ADK 服务器的命令和参数，例如（这不是直接连接到文件系统服务器，而是连接到 Cognisphere ADK，通过它来桥接）：

{
  "serverName": "cognisphere-adk-server",
  "command": "python",
  "args": [
    "app.py" // 假设 MCP 客户端可以直接运行 app.py，实际情况需要根据客户端的运行环境调整
    // 或者，如果客户端需要连接到已经运行的 Cognisphere ADK 服务器，可能不需要 command 和 args，而是通过 HTTP 或其他协议连接，这取决于客户端的实现方式。
  ],
  "env": {
    "OPENROUTER_API_KEY": "YOUR_OPENROUTER_API_KEY" // 如果 MCP 客户端也需要访问 LLM 模型，可能需要配置 API 密钥
  },
  "notes": "这只是一个示例配置，用于连接到 Cognisphere ADK 服务器。实际的 MCP 客户端配置可能需要根据客户端的具体实现和连接方式进行调整。Cognisphere ADK 作为 MCP 服务器，主要是为了桥接和管理外部 MCP 服务器，而不是直接提供 Resources, Tools, Prompts 服务。"
}

基本使用方法

启动 Cognisphere ADK 服务器 后，访问 'http://127.0.0.1:8091' (或你配置的地址)。
在 Web UI 界面中，你可以：
- 配置 MCP 集成: 在 "MCP Integration" 部分，添加和管理外部 MCP 服务器的连接。
- 管理 Identities: 创建、切换和管理 Agent 的不同身份。
- 查看 Memories 和 Narrative Threads: 管理 Agent 的记忆和叙事线索。
- 与 Agent 聊天: 在 "Chat Panel" 中与 Agent 进行对话。

关键词

认知架构, Agent框架, 上下文服务, 记忆管理, 叙事构建

关键词

使用说明

信息