关键词

智能体LLM集成工具调用上下文服务分布式系统

项目简介

KOI-MCP 是一个桥接框架，它将知识组织基础设施 (KOI) 与 Model Context Protocol (MCP) 标准相结合。它使得在 KOI 网络中的智能体能够以标准化的方式向 LLM 客户端暴露其“个性”（包括属性和可调用能力），从而增强 LLM 与智能体的交互和功能集成。

主要功能点

  • 智能体个性作为资源托管： 将 KOI 网络中的智能体及其“个性特征”（如情绪、风格、兴趣）以 MCP 资源的形式提供给 LLM 客户端。
  • 智能体可调用能力作为工具注册： 将智能体中定义为“可调用”的特性（Traits）注册为 MCP 工具，允许 LLM 调用这些外部功能。
  • 协调器注册服务： 提供一个集中的注册服务器，LLM 客户端可以查询该服务器来发现网络中所有可用的智能体资源和工具。
  • 智能体独立服务器： 每个智能体也可以运行一个独立的 MCP 服务器，直接暴露其自身的个性和可调用能力。
  • 基于标准的交互： 通过实现 MCP 协议的核心概念（尽管传输层实现可能使用 HTTP 等常见协议而非严格限制 JSON-RPC over Stdio/SSE/WebSocket），为 LLM 客户端与智能体之间的交互提供结构化接口。

安装步骤

  1. 克隆仓库： 
    git clone https://github.com/BlockScience/koi-mcp.git
cd koi-mcp
  2. 创建并激活虚拟环境： 建议使用 'uv' 工具，如果没有安装，请先安装 'pip install uv'。 
    uv venv --python 3.12
source .venv/bin/activate  # Windows 用户请使用：.venv\Scripts\activate
  3. 安装依赖： 
    uv pip install -e ".[dev]"

服务器配置（为 MCP 客户端准备）

要让 MCP 客户端连接到 KOI-MCP 服务器，客户端需要知道如何启动服务器进程（如果服务器不是预先运行的）以及连接的网络地址。

对于连接协调器（推荐用于发现所有智能体和工具）：

  • 服务器名称： 例如，'koi-mcp-coordinator'
  • 启动命令 (command)： 'python'
  • 启动参数 (args)： '["-m", "koi_mcp.main", "coordinator", "--config", "configs/coordinator.json"]'
  • 网络连接信息： 服务器通常会在配置的端口启动 HTTP 服务。默认端口是 '9000'。客户端需要配置连接到 'http://localhost:9000'（或实际部署的 IP/域名）。

对于直接连接某个智能体：

  • 服务器名称： 例如，'helpful-agent-mcp' 或 'creative-agent-mcp'
  • 启动命令 (command)： 'python'
  • 启动参数 (args)：
    • 对于第一个智能体示例：'["-m", "koi_mcp.main", "agent", "--config", "configs/agent1.json"]'
    • 对于第二个智能体示例：'["-m", "koi_mcp.main", "agent", "--config", "configs/agent2.json"]'
  • 网络连接信息： 服务器通常会在配置的端口启动 HTTP 服务。'agent1.json' 默认端口是 '8101'，'agent2.json' 默认端口是 '8102'。客户端需要配置连接到 'http://localhost:8101' 或 'http://localhost:8102'（或实际部署的 IP/域名）。

注意：上述 'command' 和 'args' 是启动服务器进程所需的命令行信息。MCP 客户端会使用这些信息启动服务器并在服务器启动后通过网络地址建立连接。实际的网络协议是 HTTP，MCP 协议的资源和工具接口通过 RESTful 风格的端点暴露。

基本使用方法

安装完成后，最快的使用方法是运行演示脚本：

python scripts/demo.py

此脚本会启动协调器和两个示例智能体。服务器启动后，您可以在浏览器中访问以下地址查看 MCP 接口：

  • 协调器注册表资源列表：'http://localhost:9000/resources/list'
  • 协调器注册表工具列表：'http://localhost:9000/tools/list'
  • “helpful-agent”智能体资源列表：'http://localhost:8101/resources/list'
  • “helpful-agent”智能体工具列表：'http://localhost:8101/tools/list'
  • “creative-agent”智能体资源列表：'http://localhost:8102/resources/list'
  • “creative-agent”智能体工具列表：'http://localhost:8102/tools/list'

您也可以单独启动协调器或智能体：

# 启动协调器
python -m koi_mcp.main coordinator --config configs/coordinator.json

# 启动第一个智能体
python -m koi_mcp.main agent --config configs/agent1.json

# 启动第二个智能体
python -m koi_mcp.main agent --config configs/agent2.json

信息

分类

AI与计算

访问项目