AI导哈

知识图谱集成插件

Caves插件是一个连接Claude Code与Caves知识图谱的工具，通过云服务器实现概念连接、内容分析和知识管理。

  • by ic-caves
  • 本地部署
  • 更新于
在 GitHub 查看 ic-caves/caves-claude-plugin

使用说明

Caves Plugin for Claude Code

Integrate Caves knowledge graph with Claude Code through the Caves Oracle MCP server.

Features

  • 🔗 Connect concepts and build knowledge graphs
  • 🧠 Turn conversations, articles, and transcripts into connections
  • 🔍 Search and navigate your Caves perspectives
  • ☁️ Cloud-based MCP server (no local installation required)

Prerequisites

  • Caves account (sign up at https://itscaves.com)

Installation

Quick Install (Recommended)

# Add the ic-caves marketplace
/plugin marketplace add ic-caves/caves-claude-plugin

# Install the plugin
/plugin install caves@ic-caves-caves-claude-plugin

Manual Install

# Clone the repository
git clone https://github.com/ic-caves/caves-claude-plugin.git

# Add as a local marketplace
/plugin marketplace add ./caves-claude-plugin

# Install the plugin
/plugin install caves@caves-claude-plugin

Verification

Check that the plugin loaded successfully:

/plugin
# Look for "caves" in the Installed tab

Authenticate with Caves

On first use, Claude Code will prompt you to authenticate:

  1. A browser window will open to itscaves.com
  2. Log in with your Caves account
  3. Authorize Claude Code to access your Caves data
  4. Return to Claude Code - authentication is complete!

Verification

Test the installation:

# In Claude Code, try:
"Show me my Caves perspectives"

You should see your perspectives listed.

Skills Included

caves-knowledge

Knowledge center for Caves - answers questions by searching documentation, blog, and the Caves system.

Usage:

  • Ask questions about Caves concepts: "What is fire in Caves?"
  • Get feature explanations: "How do perspectives work?"
  • Find documentation: "How do I add content?"
  • The skill searches local docs, the blog, and can use MCP tools for live examples

content-to-caves

Analyze text — conversations, articles, transcripts — and generate knowledge graph connections.

Usage:

  • Say "analyze this and add it to Caves" or paste/point at text
  • The skill extracts entities, validates them against existing knowledge, and creates connections
  • Review the suggested connections before they're written to your perspective

agent-signup

Guide Claude agents through Caves account registration with email verification.

Usage:

  • Say "I need to create a Caves account"
  • Say "register for Caves" or "agent signup"
  • The skill will guide you through the 3-step process:
    1. Gather email and username information
    2. Submit registration and send verification email
    3. Poll for human verification and retrieve credentials
  • IMPORTANT: API key is shown only once - save it securely!

api-reference

Complete HTTP API reference for Caves with authentication, endpoints, and curl examples.

Usage:

  • Say "show me the Caves API documentation"
  • Say "how do I make HTTP requests to Caves"
  • Say "API reference" or "curl examples"
  • Provides direct API access alternative to MCP tools
  • Includes authentication, all endpoints, request/response examples
  • Use when building custom integrations or scripts outside Claude Code

MCP Tools Available

The Caves Oracle MCP server provides these tools:

  • caves__search_caves - Search for tags/caves by query
  • caves__my_shadows - Get your perspectives (PIDs) with descriptions
  • caves__connect_caves - Create connections between caves/tags
  • caves__disconnect_caves - Remove connections between caves
  • caves__get_subcaves - Get child caves for a parent cave
  • caves__my_shadow_caves - Get complete graph for a perspective
  • caves__get_shadows_for_tags - Find PIDs that have connected to specific tags
  • caves__get_shadows_for_connection - Find PIDs that agree/disagree on a connection
  • caves__create_shadow - Create a new perspective with a username
  • caves__read_ipfs - Read IPFS content (images/text) from caves

Configuration

Authentication

No manual configuration required! The plugin uses OAuth for authentication:

  • First use prompts browser-based login
  • Credentials securely stored by Claude Code
  • Re-authentication only needed if token expires

Caves URL Schema

Access caves directly via URLs:

https://itscaves.com/c/{url-encoded-cave-name}

Examples:

  • https://itscaves.com/c/smoke%20and%20pickles
  • https://itscaves.com/c/edward%20lee
  • https://itscaves.com/c/kimchi

Troubleshooting

"caves-mcp MCP server not found"

  • Restart Claude Code to load the plugin
  • Check that the plugin is installed in ~/.claude/plugins/caves
  • Verify .mcp.json file exists in the plugin directory

"Authentication failed" or "Login required"

  • Click the authentication prompt when it appears
  • Complete the OAuth flow in your browser
  • If browser doesn't open, check for popup blockers
  • Try logging out and back in at itscaves.com

"Connection timeout"

  • Check your internet connection
  • Verify https://oracle.itscaves.com is accessible
  • Try again in a few moments (server may be updating)

Usage Examples

View Your Perspectives

"Show me all my Caves perspectives"

Search for Caves

"Search Caves for 'fermentation' tags"

Create Connections

"Connect 'kimchi' to 'fermented foods' in my Caves perspective"

Analyze Content into Connections

"Analyze this article and add the connections to my Caves perspective"

Documentation

  • Caves Website: https://itscaves.com
  • Discord Community: https://discord.com/invite/8bW2xwv7kc
  • MCP Server: https://oracle.itscaves.com/sse
  • Caves Documentation: https://github.com/ic-caves/caves-docs - Technical documentation and guides for the Caves knowledge graph system
  • .ic File Format: https://github.com/ic-caves/ic-docs - Documentation for the .ic file format (underlying data structure)

License

MIT

Contributing

Issues and PRs welcome at https://github.com/ic-caves/caves-claude-plugin

相关 MCP