项目简介

HyperCortex Mesh协议（HMP）旨在构建去中心化的AI认知网络。HMP-Agent是该协议的一个核心实现，它可以作为一个独立的认知核心，也可以作为“认知连接器”（Cognitive Connector）将外部LLM连接到Mesh网络。本描述主要关注其作为MCP服务器提供的“认知连接器”功能，它通过API接口管理和公开代理的日记、概念图、笔记等多种上下文信息。

主要功能点

上下文信息托管与访问： 允许LLM客户端读取和写入代理的认知日记、创建和查询语义图中的概念与链接、管理用户笔记等。
LLM工具接口： 间接提供工具调用能力，LLM可以通过API指令触发代理内部的Shell命令执行或数据修改等操作。
模块化与可扩展性： HMP-Agent设计为模块化架构，不同组件（如核心思考循环、Web用户界面、Mesh网络同步等）可以独立或协同运行。
去中心化网络集成： 内置Peer Sync模块，支持与其他HMP代理发现、连接和交换信息，以构建分布式认知网络。
代理身份与安全： 提供基于DID（去中心化身份）和密钥对的身份管理，支持地址工作量证明（PoW）验证。

安装步骤

克隆仓库：

git clone https://github.com/kagvi13/HMP.git

进入项目目录：
```
cd HMP
```

安装Python依赖： 项目依赖如'fastapi', 'uvicorn', 'pydantic', 'requests', 'cryptography', 'PyYAML', 'netifaces', 'python-dateutil'等。请确保已安装这些依赖。建议创建一个虚拟环境并安装：

python -m venv venv
source venv/bin/activate  # macOS/Linux
# 或 'venv\Scripts\activate' # Windows
pip install fastapi uvicorn pydantic requests cryptography PyYAML netifaces python-dateutil Jinja2 Werkzeug

初始化数据库与配置： 运行初始化脚本，它将创建SQLite数据库、生成代理DID和密钥，并加载初始配置和Prompt模板。
```
python agents/init.py
```
启动HMP-Agent MCP服务器： 'agents/mcp_server.py'是提供核心API服务的组件。您可以单独启动它：
```
uvicorn agents.mcp_server:app --host 127.0.0.1 --port 8000
```
或者通过'start_repl.py'启动包含MCP服务器在内的多个Agent组件：
```
python agents/start_repl.py
```
（请注意，'agents/start_repl.py'中需要将'ENABLE_UI'设置为'True'，因为它会启动Web UI，而Web UI内部使用了'mcp_server.py'提供的功能，或可以直接修改'start_repl.py'以显式启动'mcp_server.py'服务。）

服务器配置 (MCP客户端使用)

MCP客户端需要配置与HMP-Agent的“认知连接器”通信。该连接器通过HTTP协议提供JSON API服务。以下是一个MCP客户端可参考的配置信息（JSON格式示例），客户端将使用这些信息来启动和连接MCP服务器：

{
  "server_name": "HMP_Agent_Connector_API",
  "command": "uvicorn",
  "args": [
    "agents.mcp_server:app",
    "--host", "127.0.0.1",
    "--port", "8000"
  ],
  "description": "连接到HMP-Agent的认知连接器，提供对日记、概念图和笔记等上下文资源的API访问。",
  "api_base_url": "http://127.0.0.1:8000"
}

'server_name': MCP服务器的唯一标识名称，方便客户端识别。
'command': 启动HMP MCP服务器进程的命令。此处为'uvicorn'，用于运行基于FastAPI的Python应用。
'args': 传递给'uvicorn'命令的参数列表。
- 'agents.mcp_server:app': 指定FastAPI应用模块 ('agents.mcp_server') 及其应用实例 ('app')。
- '--host 127.0.0.1': MCP服务器监听的IP地址，通常为本地回环地址。
- '--port 8000': MCP服务器监听的端口号。
'description': 对该MCP服务器功能的简要说明，帮助LLM客户端理解其作用。
'api_base_url': MCP客户端通过此URL向服务器发送HTTP请求，进行数据交互和功能调用。

基本使用方法

启动HMP-Agent MCP服务器： 按照“安装步骤”中的说明启动'mcp_server.py'。
配置LLM客户端： 在您的LLM客户端（例如，一个支持MCP协议的LLM代理框架）中，使用上述“服务器配置”信息来连接HMP-Agent MCP服务器。
LLM交互： LLM客户端现在可以通过'api_base_url'与HMP-Agent进行通信，利用其提供的API来：
- 查询代理日记： 获取代理的思考历史、感知到的事件或关键决策过程。
- 操作语义图： 添加、查询或修改概念及其之间的关系，用于知识表示和推理。
- 管理用户笔记： 读取用户通过笔记提供的指令或反馈，或向用户记录重要的思考结果。
- 执行特定命令： LLM可以生成结构化指令，通过API触发HMP-Agent内部定义的工具（如Shell命令、数据处理脚本等）。

关键词

项目简介

主要功能点

安装步骤

服务器配置 (MCP客户端使用)

基本使用方法

信息