模型上下文协议服务器

Mycelium是Grove生态系统的模型上下文协议(MCP)服务器,使AI代理(Claude)能够与整个Grove生态系统交互。

  • by AutumnsGrove
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 AutumnsGrove/Mycelium

使用说明

菌丝体

格罗夫生态系统的森林网络

菌丝体 是Grove的模型上下文协议(MCP)服务器,这是一个让AI代理(Claude)与整个Grove生态系统交互的通信网络。就像真菌菌丝体网络连接森林中的树木一样,菌丝体将克劳德连接到莱迪思、心木、琥珀、布鲁姆和其他格罗夫服务。

一句话: “克劳德通过菌丝体与格罗夫交谈。”


特性

  • 耐用物体上的McpAgent -每个MCP会话都是一个全局唯一、持久的持久对象
  • Heartwood OAuth -与Grove现有的身份验证基础设施集成
  • 多运输支持 -流式HTTP、SSE和WebSocket
  • 完全Grove集成 -适用于所有Grove服务的工具

MCP工具

服务 工具
晶格 (博客) 创建、阅读、更新、删除博客文章
绽放 (远程开发) 启动/停止编码会话,提交任务
琥珀 (存储) 上传、下载、列出R2中的文件
戒指 (分析) 查询指标、查看事件、仪表板
草地 (社交) 发布、查看订阅源、管理关注
侦察兵 (交易) 搜索交易、跟踪价格、获取提醒

快速开始

先决条件

  • Node.js 20+
  • pnpm
  • Cloudflare帐户
  • Heartwood OAuth凭据

安装

# Clone and install
git clone https://github.com/AutumnsGrove/Mycelium.git
cd Mycelium
pnpm install

# Configure Cloudflare
npx wrangler kv namespace create "OAUTH_KV"
npx wrangler secret put HEARTWOOD_CLIENT_ID
npx wrangler secret put HEARTWOOD_CLIENT_SECRET
npx wrangler secret put COOKIE_ENCRYPTION_KEY

# Update wrangler.jsonc with your KV namespace ID

发展

# Start local dev server
pnpm dev

# Run type checking
pnpm typecheck

# Deploy to production
pnpm deploy

连接到克劳德

第ai条(连接器)

  1. 设置 -> 连接器 -> 添加自定义连接器
  2. 网址: https://mycelium.grove.place/mcp
  3. 通过Heartwood进行身份验证
  4. 启用所需工具

克劳德桌面

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "grove": {
      "command": "npx",
      "args": ["mcp-remote", "https://mycelium.grove.place/sse"]
    }
  }
}

克劳德代码

添加到MCP服务器配置或通过Claude.ai连接器使用。


建筑

┌─────────────────────────────────────────────────────────────────────────────┐
│                            MCP CLIENTS                                       │
│  ┌─────────────┐  ┌─────────────────┐  ┌─────────────┐  ┌─────────────┐    │
│  │  Claude.ai  │  │ Claude Desktop  │  │ Claude Code │  │   Cursor    │    │
│  └──────┬──────┘  └────────┬────────┘  └──────┬──────┘  └──────┬──────┘    │
└─────────┼──────────────────┼──────────────────┼──────────────────┼──────────┘
          │         SSE / Streamable HTTP / WebSocket              │
          └──────────────────┴─────────┬────────┴──────────────────┘
                                       │
┌──────────────────────────────────────┴──────────────────────────────────────┐
│                     MYCELIUM (Cloudflare Worker)                             │
│  ┌─────────────────────────────────────────────────────────────────────┐   │
│  │                    MyceliumDO (Durable Object per Session)          │   │
│  │  ┌─────────────────┐  ┌─────────────────┐  ┌─────────────────┐     │   │
│  │  │  Session State  │  │  SQLite Storage │  │   Hibernation   │     │   │
│  │  └─────────────────┘  └─────────────────┘  └─────────────────┘     │   │
│  └─────────────────────────────────────────────────────────────────────┘   │
└──────────────────────────────────────┬──────────────────────────────────────┘
                                       │
┌──────────────────────────────────────┴──────────────────────────────────────┐
│                          GROVE ECOSYSTEM                                     │
│  ┌───────────┐  ┌───────────┐  ┌───────────┐  ┌───────────┐  ┌───────────┐ │
│  │  Lattice  │  │ Heartwood │  │   Amber   │  │   Bloom   │  │   Rings   │ │
│  │  (blogs)  │  │  (auth)   │  │ (storage) │  │ (dev env) │  │(analytics)│ │
│  └───────────┘  └───────────┘  └───────────┘  └───────────┘  └───────────┘ │
└─────────────────────────────────────────────────────────────────────────────┘

项目结构

mycelium/
├── src/
│   ├── index.ts              # Main entry, exports Mycelium class
│   ├── types.ts              # Shared type definitions
│   ├── tools/                # MCP tool implementations
│   │   ├── lattice.ts        # Blog tools
│   │   ├── bloom.ts          # Remote dev tools
│   │   ├── amber.ts          # Storage tools
│   │   ├── rings.ts          # Analytics tools
│   │   ├── meadow.ts         # Social tools
│   │   ├── scout.ts          # Deal finding tools
│   │   └── context.ts        # Session management tools
│   ├── auth/
│   │   └── heartwood.ts      # OAuth handler
│   └── state/
│       ├── schema.ts         # State type definitions
│       └── migrations.ts     # SQL migrations
├── docs/
│   ├── SPEC.md               # Full project specification
│   └── grove-mcp-guide.md    # MCP implementation guide
├── tests/                    # Test files
├── wrangler.jsonc            # Cloudflare Workers config
├── package.json
├── tsconfig.json
└── README.md

开发状态

当前阶段: 第0阶段-脚手架安装完成

  • [x] 项目结构
  • [x] 配置文件
  • [x] 类型定义
  • [x] 工具头(共7组)
  • [x] 身份验证处理程序存根
  • [x] 州管理存根
  • []第一阶段:基础(MVP)
  • []第2阶段:Bloom集成
  • []第三阶段:完整生态系统
  • []第4阶段:高级功能

看 TODOS.md 用于详细的任务跟踪。


成本分析

资源 可用层 预期使用量
工人请求 100K/天 ~1K/天
耐用物品 1M需求/月 ~30K/月
DO存储 1 GB ~10 MB
KV操作 100K/天 ~100/天

预计每月费用:0美元 (免费等级足以供个人使用)


参考文献


“森林通过它的根说话。”

作者 秋棕色 域名: 菌丝体批准地点 状态: 第0阶段-脚手架