Koi MCP

🚀 KOI - MCP項目

KOI - MCP 是一個將基於 KOI - Net 的分佈式知識網絡與模型上下文協議（MCP）集成的框架。該項目致力於把去中心化的知識處理能力與先進的大語言模型（LLM）工具相結合，從而構建出更加智能、互聯的人工智能生態系統。

🚀 快速開始

KOI - MCP 可通過 pip 輕鬆安裝，安裝命令如下：

pip install koi-mcp

✨ 主要特性

分佈式知識處理

KOI 作為一個分佈式的知識網絡協議，可用於在區塊鏈上組織和共享可信的知識。藉助 KOI - Net 庫，開發者能夠創建去中心化的知識節點、處理知識對象，並實現分佈式協作。

集成大語言模型

KOI - MCP 的目標是將 KOI 網絡的分佈式知識處理能力與 MCP 協議的 LLM 工具標準化接口相結合，使知識網絡能直接與各種 LLM 工具集成，構建更智能的應用場景。

📦 安裝指南

使用以下命令安裝 KOI - MCP：

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：模型上下文協議框架。

如需瞭解更多信息，請訪問我們的文檔頁面或加入開發者社區。