Koi MCP

🚀 KOI-MCP项目

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

🚀 快速开始

你可以通过以下命令安装 KOI-MCP：

pip install koi-mcp

✨ 主要特性

分布式知识处理

KOI 作为分布式知识网络协议，可在区块链上组织和共享可信知识。借助 KOI-Net 库，开发者能够创建去中心化知识节点、处理知识对象并实现分布式协作。

目标达成

KOI-MCP 把 KOI 网络的分布式知识处理能力和 MCP 协议的 LLM 工具标准化接口相结合，让知识网络能直接与各类 LLM 工具集成，构建更智能的应用场景。

📦 安装指南

使用以下命令进行安装：

pip install koi-mcp

💻 使用示例

基础用法

创建一个新知识节点

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 接口使用

📚 详细文档

架构概述

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

运行测试

# 初始化数据库
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：模型上下文协议框架。

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