使用说明

项目简介

Heurist Mesh Agent 服务器是 Heurist Agent Framework 的一部分，它实现了 Model Context Protocol (MCP) 协议，允许大型语言模型 (LLM) 客户端通过标准化的 JSON-RPC 接口访问和利用框架内的各项能力。该服务器专注于提供上下文信息和功能，支持资源管理、工具注册与执行以及 Prompt 模板渲染，从而增强 LLM 应用的功能和灵活性。

主要功能点

资源 (Resources) 管理：虽然仓库内容未直接展示资源管理的具体实现，但框架架构设计和 MCP 服务器的定义暗示了资源管理是其核心功能之一，用于托管和提供数据访问能力。
工具 (Tools) 注册与执行：框架明确支持 Tool 集成，并通过 'core/tools/tools_mcp.py' 和 'clients/mcp_client.py' 等文件体现了对 MCP 工具的支持和客户端能力，暗示服务器端具备工具注册和执行的能力。
Prompt 模板 (Prompts) 定义和渲染：框架包含 'core/config.py' 和 'agents/config/prompts.yaml' 等文件，用于定义和管理 Prompt 模板，MCP 服务器应负责根据客户端请求提供和渲染这些模板。
JSON-RPC 协议通信：'clients/mcp_client.py' 文件作为 MCP 客户端，通过 SSE 与服务器通信，暗示服务器端实现了 JSON-RPC over SSE 协议，符合 MCP 定义。
会话管理和能力声明：虽然代码中没有显式展示会话管理和能力声明的具体实现，但作为 MCP 服务器的必要组成部分，框架设计上应支持这些功能。
多种传输协议支持：仓库主要展示了 SSE 的使用 ('clients/mcp_client.py', 'main_mcp.py')，但框架设计上具有支持 Stdio, WebSocket 等其他传输协议的潜力。

安装步骤

由于 'heurist-agent-framework' 是一个框架，要运行 MCP 服务器，您需要基于此框架搭建并配置相应的服务器应用。以下是基本步骤：

克隆仓库

git clone https://github.com/heurist-network/heurist-agent-framework
cd heurist-agent-framework

安装依赖

建议使用虚拟环境：

python -m venv venv
source venv/bin/activate  # 或 venv\Scripts\activate for Windows
pip install -r requirements.txt
cd core
pip install -e .
cd ..

请确保 'core/requirements.txt' 和根目录下的 'requirements.txt' 都已安装。

配置环境变量

复制 '.env.example' 文件并重命名为 '.env'，根据需要配置 API 密钥、数据库连接等环境变量。特别是，运行 'main_mcp.py' 需要配置 Heurist API Key ('HEURIST_API_KEY') 和 MCP 服务器地址等。

服务器配置

MCP 服务器配置信息（'server.json' 示例）：

{
  "serverName": "Heurist MCP Server",
  "command": "python",
  "args": [
    "main_mcp.py",
    "http://localhost:8000/sse"  // 请替换为您的 MCP SSE 服务器地址，如果使用其他传输协议，请修改 main_mcp.py 或配置相应的启动脚本
  ],
  "protocol": "mcp-json-rpc",
  "transport": "sse",
  "description": "Heurist Agent Framework MCP Server",
  "capabilities": [
    "resources",
    "tools",
    "prompts"
  ]
}

'serverName': MCP 服务器的名称，可自定义。
'command': 启动 MCP 服务器的命令，这里假设使用 Python 运行 'main_mcp.py'。
'args': 启动命令的参数，'main_mcp.py' 需要 MCP SSE 服务器地址作为参数，示例中使用了 'http://localhost:8000/sse'。请注意，实际部署时您可能需要配置真实的服务器地址和端口。
'protocol': 固定为 'mcp-json-rpc'，表明使用 MCP 协议。
'transport': 指定传输协议，示例中使用 'sse' (Server-Sent Events)。
'description': 服务器描述信息。
'capabilities': 声明服务器支持的 MCP 核心能力，包括 'resources', 'tools', 'prompts'。

基本使用方法

启动 MCP 服务器

打开终端，进入 'heurist-agent-framework' 目录，运行 'main_mcp.py' 脚本，并提供 MCP SSE 服务器地址作为参数：
```
python main_mcp.py http://localhost:8000/sse
```
这将启动一个简单的 MCP 客户端，连接到指定的 SSE 服务器。要作为 MCP 服务器被客户端连接，您可能需要基于框架实现一个 MCP 服务器端应用，或者配置 'heurist-mesh-mcp-server' （如果存在于提供的仓库信息之外）。提供的 'main_mcp.py' 更多的是一个 MCP 客户端示例，用于测试 MCP 工具的调用。
使用 MCP 客户端连接

使用支持 MCP 协议的客户端（例如 Claude Desktop, Cursor, Windsurf 等），配置上述 'server.json' 中的连接信息，客户端即可与 MCP 服务器建立连接，并利用服务器提供的资源、工具和 Prompt 功能。

您可以使用 'main_mcp.py' 提供的交互模式测试工具调用功能，输入 'tool:<tool_name> <json_parameters>' 即可直接调用 MCP 服务器提供的工具。例如 'tool:coingecko_get_crypto_price {"token_name": "bitcoin"}'

请注意： 'heurist-agent-framework' 本身更偏向于 AI Agent 框架，要搭建一个完整的、可被 MCP 客户端直接连接的 MCP 服务器，可能需要参考 'heurist-mesh-mcp-server' 仓库（未在本次分析范围内）或者基于 'heurist-agent-framework' 中的组件进行二次开发和定制。 'main_mcp.py' 文件更多地展示了如何作为一个 MCP 客户端来使用 MCP 工具，而非一个独立的、开箱即用的 MCP 服务器。

关键词

使用说明

信息