项目介绍

KOI-MCP 是一个基于 KOI-Net 的分布式知识网络与模型上下文协议（MCP）集成的框架。该项目旨在将去中心化的知识处理能力与先进的大语言模型（LLM）工具结合，构建更智能、互联的人工智能生态系统。

安装

pip install koi-mcp

什么是 KOI？

KOI 是一个分布式的知识网络协议，用于在区块链上组织和共享可信的知识。通过 KOI-Net 库，开发者可以创建去中心化的知识节点、处理知识对象，并实现分布式协作。

项目目标

KOI-MCP 的目标是将 KOI 网络的分布式知识处理能力与 MCP 协议的 LLM 工具标准化接口相结合。通过这种方式，知识网络能够直接与各种 LLM 工具集成，构建更智能的应用场景。

架构概述

graph LR
    A[Knowledge Node] --> B(KOI-NET)
    B --> C(Model Context Protocol Adapter)
    C --> D[LLM Tools]

主要功能模块

知识处理管道

通过 KOI 的知识对象处理器，将分布式知识网络与 LLM 工具连接起来。

@processor.register_handler(HandlerType.Bundle, rid_types=[AgentPersonality])
def personality_bundle_handler(proc: ProcessorInterface, kobj: KnowledgeObject):
    try:
        profile = PersonalityProfile.model_validate(kobj.contents)
        if mcp_adapter is not None:
            mcp_adapter.register_agent(profile)
        return kobj
    except ValidationError:
        return STOP_CHAIN

人格模型

定义和处理智能体的人格特质，使其能够动态更新。

{
  "traits": {
    "mood": "enthusiastic",
    "new_capability": {
      "description": "A new capability added at runtime",
      "is_callable": true
    }
  }
}

MCP 适配器

将 KOI 网络与 MCP 协议进行桥接，提供 RESTful API 接口。

# 运行 MCP 注册服务器
python -m koi_mcp.server.registry --port=9000

# 启动智能体服务器
python -m koi_mcp.server.agent --name=helpful-agent --port=8101

使用示例

创建一个新知识节点

from koi_net.node import KoiNode

node = KoiNode(name="my-koi-node", contact_url="http://localhost:8000/koi-net")
node.start()

定义和处理人格特质

{
  "agent": {
    "name": "helpful-agent",
    "personality": {
      "traits": {
        "openness": 0.8,
        "conscientiousness": 0.9,
        "extraversion": 0.7,
        "agreeableness": 0.6",
        "neuroticism": 0.5
      }
    }
  }
}

MCP 接口定义

运行测试

# 初始化数据库
python -m koi_mcp.utils.db init --db-path=./data/db.sqlite

# 启动服务
python -m koi_mcp.server.registry --port=9000 &
python -m koi_mcp.server.agent --name=test-agent --port=8102 &

项目结构

koi-mcp/
├── koi_mcp/
│   ├── adapters/          # MCP 协议适配器
│   ├── handlers/         # 处理器模块
│   ├── models/           # 数据模型定义
│   └── utils/           # 工具函数
└── README.md             # 项目文档

许可证

该项目使用 MIT 许可证。请参阅 LICENSE 文件以获取详细信息。

致谢

感谢以下项目的贡献：

• KOI-Net：分布式知识网络协议。
• MCP：模型上下文协议框架。

如需了解更多信息，请访问我们的文档页面或加入开发者社区。