kairos-chain

KairosChain MCP Server

Self-referential MCP server for auditable skill self-management

📖 日本語版 README はこちら (Japanese README)

KairosChain is a Model Context Protocol (MCP) server for self-managed, evolvable AI skill definitions. It combines Pure Skills design (Ruby DSL/AST) with a private blockchain, enabling AI agents to define, evolve, and audit their own capabilities through self-referential skill management.

Table of Contents

• Philosophy
  • The Problem
  • The Solution: KairosChain
  • Minimum-Nomic Principle
• Architecture
  • System Overview
  • P2P Knowledge Exchange
• Layered Skills Architecture
  • L0: Kairos Core (skills/)
  • L1: Knowledge Layer (knowledge/)
  • L2: Context Layer (context/)
  • Why Layered Architecture?
• Data Model: SkillStateTransition
• Setup
  • Prerequisites
  • Installation
  • Optional: RAG (Semantic Search) Support
  • Optional: SQLite Storage Backend (Team Use)
  • Optional: Streamable HTTP Transport (Remote/Team Access)
  • Admin UI (Browser-Based Management)
• Client Configuration
  • Claude Code Configuration (Detailed)
  • Cursor IDE Configuration (Detailed)
• Upgrading the Gem
  • How It Works
  • L1 Knowledge Updates (v1.0.0+)
  • Upgrade Commands
  • Version Mismatch Warning
  • Upgrade Workflow
• MMP SkillSet Setup (P2P Communication)
  • Installing the MMP SkillSet
  • Configuring meeting.yml
  • Starting the P2P HTTP Server
  • Testing P2P Connectivity
• Testing the Setup
  • 1. Basic Command Line Tests
  • 2. Skills Tools Test
  • 3. Blockchain Tools Test
  • 4. Testing with SQLite Backend (Optional)
  • 5. Testing with RAG / Semantic Search (Optional)
  • 6. Testing HTTP Mode (Optional)
  • 7. Testing with Claude Code
  • 8. Testing with Cursor
  • Troubleshooting
• Usage Tips
  • Basic Usage
  • Practical Usage Patterns
  • Best Practices
  • Tool Discovery with tool_guide
  • Common Commands Reference
  • Security Considerations
• Available Tools (26 core + skill-tools)
  • L0-A: Skills Tools (Markdown) - Read-only
  • L0-B: Skills Tools (DSL) - Full Blockchain Record
  • L0: Instructions Management - Full Blockchain Record
  • Cross-Layer Promotion Tools
  • Audit Tools - Knowledge Lifecycle Management
  • Resource Tools - Unified Access
  • L1: Knowledge Tools - Hash Reference Record
  • L2: Context Tools - No Blockchain Record
  • Blockchain Tools
  • State Commit Tools (Auditability)
  • Authentication Tools (HTTP Mode Only)
  • Guide Tools (Tool Discovery)
  • System Management Tools
  • MMP Meeting Tools (SkillSet: mmp)
  • Multiuser Tools (SkillSet: multiuser)
• Usage Examples
  • List Available Skills