chittymcp (Chittyos)

ChittyMCP-整合的MCP服务器

版本3.0.0 -用于ChittyOS生态系统的模块化、整合的模型上下文协议服务器。

  

______________________________________________________________________

✨ v3.0.0中的新增功能

模块化架构 -完全重构为：

• ✅ 核心模块 具有可重用的MCP服务器基类
• ✅ 动态刀具加载 -在不接触核心代码的情况下添加工具
• ✅ 集成层 -集中式ChittyOS服务客户端
• ✅ 链执行 -多工具工作流编排
• ✅ 15+工具 跨4个领域（证据、法律、基础设施、同步）

新结构:

src/
├── core/           # Shared utilities (BaseMCPServer, ToolLoader, ChainExecutor)
├── integration/    # Service clients (ChittyID, Cloudflare, Notion)
├── tools/          # Modular tools (evidence, legal, infrastructure, sync)
└── servers/        # Server implementations (unified, evidence)

______________________________________________________________________

状态

______________________________________________________________________

快速开始

安装

# Install dependencies
npm install

正在运行的服务器

# Unified server (all 15+ tools + chain execution)
npm start

# Evidence server only (4 tools)
npm start:evidence

# Development mode with auto-reload
npm run dev
npm run dev:evidence

环境变量

# ChittyOS Core
CHITTY_ID_TOKEN=
CHITTYID_SERVICE=https://id.chitty.cc
CHITTY_ENV=production

# Cloudflare (optional)
CLOUDFLARE_API_TOKEN=
CLOUDFLARE_ACCOUNT_ID=bbf9fcd845e78035b7a135c481e88541

# Notion (optional)
NOTION_TOKEN=
NOTION_DATABASE_ID=

# Logging
LOG_LEVEL=INFO  # DEBUG|INFO|WARN|ERROR

______________________________________________________________________

服务器

1.取证服务器✅

目的：案件管理的法律证据处理 案例：阿里亚斯诉比安奇案（2024D007847） 状态：完全工作

工具（4）:

• intake_evidence -处理和分类证据文件
• list_evidence -按类别查询证据
• get_evidence_stats -获取案例统计数据
• start_intake_monitoring -监视新文件的目录

特性:

• SHA256重复检测
• 14个证据类别
• 监管链跟踪
• 使用chokidar进行实时文件监控
• Google Drive集成
• PostgreSQL注册表（可选）

证据路径: /Users/nb/Evidence-Intake/2024D007847-Arias-v-Bianchi/

示例:

// Intake evidence
await intake_evidence({
  files: ["/path/to/document.pdf"],
  category: "07_COURT_FILINGS",
  priority: "high"
});

______________________________________________________________________

2.统一整合服务器🟡

目的：集成ChittyOS的多域MCP服务器 状态：模式完整，实现主要是占位符 版本: 3.0.0

工具（19） -按域组织：

高管（5）-⚠️ 占位符实现

• analyze_performance -返回模拟性能数据
• risk_assessment -返回模拟风险数据
• make_executive_decision -返回模板决策
• strategic_planning -返回占位符计划
• delegate_task -返回模拟任务委派

法律（7）-🟡 部分执行

• generate_chitty_id - ✅ 工作正常（调用id.chitty.cc），有回退功能
• create_legal_case - ⚠️ 占位符
• analyze_document - ⚠️ 占位符
• process_payment - ⚠️ 占位符
• compliance_check - ⚠️ 占位符
• search_cases - ⚠️ 占位符
• execute_workflow - ⚠️ 占位符

基础设施（4）-⚠️ 占位符实现

• deploy_worker -返回模拟部署结果
• manage_kv_namespace -返回模拟KV操作
• manage_r2_bucket -返回模拟R2操作
• execute_d1_query -返回模拟查询结果

同步（3）-⚠️ 占位符实现

• register_mcp_server -返回模拟注册
• sync_mcp_state -返回模拟同步状态
• get_synced_servers -返回空列表

链工作流：中定义了5条链 config/chains.json 但没有完全策划

______________________________________________________________________

3.MCP执行服务✅

目的：远程工具执行和服务发现 语言：TypeScript 状态：完全工作

工具（3）:

• execute_remote_tool -在远程MCP服务器上执行工具
• discover_services -列出可用服务
• health_check -检查服务运行状况

特性:

• 使用指数回退重试逻辑
• ChittyOS端点的服务注册表
• 超时处理
• 健康监测

已注册的服务:

• chittyid → https://id.chitty.cc
• chittyregistry → https://registry.chitty.cc
• chittygateway → https://gateway.chitty.cc

示例:

await execute_remote_tool({
  service: "chittyid",
  tool: "mint",
  arguments: { entity_type: "PEO" },
  config: { timeout: 10000, retries: 3 }
});

______________________________________________________________________

配置

Claude桌面集成

添加 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "chittymcp-unified": {
      "command": "node",
      "args": ["/absolute/path/to/chittymcp/src/servers/unified-server.js"],
      "env": {
        "CHITTY_ID_TOKEN": "${CHITTY_ID_TOKEN}",
        "CLOUDFLARE_API_TOKEN": "${CLOUDFLARE_API_TOKEN}",
        "LOG_LEVEL": "INFO"
      }
    },
    "evidence-intake": {
      "command": "node",
      "args": ["/absolute/path/to/chittymcp/src/servers/evidence-server.js"],
      "env": {}
    }
  }
}

替换 /absolute/path/to/ 你的实际路径。

传统服务器 （仍然可用）：

• mcp-evidence-server/index.js → Use src/servers/evidence-server.js 相反
• mcp-unified-consolidated/unified-server.js → Use src/servers/unified-server.js 相反

______________________________________________________________________

已知问题

1. OpenAI包 - package.json 引用了错误的包名称

- 修复： cd mcp-unified-consolidated && npm install openai@latest

1. 统一服务器工具 -大多数工具返回占位符/模拟数据

- 需要执行域、基础架构域和同步域的真正实现

1. 霓虹灯认证 -OAuth流可能超时

- 运行： neon auth login 使用前

1. 硬编码路径 -证据服务器使用 /Users/nb/Evidence-Intake

- 集 EVIDENCE_BASE_PATH 在 .env 覆盖

1. 缺少.env -默认情况下没有环境文件

- 复制 .env.example 并填写凭证

______________________________________________________________________

故障排除

看 故障排除.md 用于：

• 诊断脚本使用情况
• 常见错误修复
• 已启动服务问题（macOS）
• 网络超时解决方案
• 包依赖性修复

快速诊断:

# Run health check
bash diagnostics.sh

# Auto-fix common issues
bash mcp-repair.sh

______________________________________________________________________

发展

# Evidence server (watch mode)
cd mcp-evidence-server
npm run dev

# Unified server (watch mode)
cd mcp-unified-consolidated
npm run dev

# MCP Exec (TypeScript compilation)
cd services/mcp-exec
npm run build
npm run dev

______________________________________________________________________

部署

Cloudflare 边缘计算平台

统一服务器可以部署为Cloudflare Worker：

# Deploy to production
wrangler deploy

# Monitor logs
wrangler tail chittymcp

# Set secrets
wrangler secret put CHITTY_ID_TOKEN

看 wrangler.toml 用于配置。

______________________________________________________________________

证据类别

取证服务器支持14个类别：

文件会根据文件名模式自动分类。

______________________________________________________________________

ChittyID合规性

关键的：所有ChittyID必须通过以下方式生成 id.chitty.cc API

• 格式： CHITTY-{ENTITY}-{SEQUENCE}-{CHECKSUM}
• 实体：PEO、PLACE、PROP、EVNT、AUTH、INFO、FACT、CONTEXT、ACTOR
• 从不在本地生成ID

______________________________________________________________________

文档

• CLAUDE.md -Claude Code的详细项目概述
• 故障排除.md -常见问题和修复
• config/chains.json -链工作流定义

______________________________________________________________________

建筑

模块化设计

chittymcp/
├── src/
│   ├── core/                    # Shared core utilities
│   │   ├── mcp-server.js       # BaseMCPServer class
│   │   ├── tool-loader.js      # Dynamic tool loading
│   │   ├── chain-executor.js   # Multi-tool workflows
│   │   └── logger.js           # Centralized logging
│   ├── integration/            # ChittyOS service clients
│   │   ├── chittyid-client.js  # ChittyID service
│   │   ├── cloudflare-client.js # Cloudflare API
│   │   └── notion-client.js    # Notion integration
│   ├── tools/                  # Tool modules by domain
│   │   ├── evidence/           # 4 evidence tools
│   │   ├── legal/              # 4 legal tools
│   │   ├── infrastructure/     # 4 infrastructure tools
│   │   └── sync/               # 3 sync tools
│   └── servers/                # Server implementations
│       ├── unified-server.js   # Full consolidated server
│       └── evidence-server.js  # Standalone evidence server
├── config/
│   ├── chains.json             # Workflow chain definitions
│   └── server-config.json      # Server configuration
└── Legacy (backwards compatible):
    ├── mcp-evidence-server/
    └── mcp-unified-consolidated/

好处

• 代码重用：跨所有服务器共享实用程序
• 易于扩展：在不接触核心的情况下添加新工具
• 清洁分离：工具、集成和核心分离
• 动态加载：运行时加载的工具
• 链执行：简单工具的复杂工作流程

添加新工具

1. 在中创建工具模块 src/tools//:

// src/tools/mycategory/index.js
export const tools = [{
  name: "my_tool",
  description: "What my tool does",
  inputSchema: { /* ... */ }
}];

export { handlers } from "./handlers.js";

// src/tools/mycategory/handlers.js
export const handlers = {
  async my_tool(args) {
    return {
      content: [{
        type: "text",
        text: "Result"
      }]
    };
  }
};

1. 重新启动服务器-工具会自动加载！

工作流链

执行中定义的多工具工作流 config/chains.json:

// Execute a chain
await execute_chain({
  chain_name: "legal-workflow",
  parameters: {
    case_type: "civil",
    documents: ["/path/to/filing.pdf"],
    client_id: "CHITTY-PEO-..."
  }
});

可用链条:

• executive-decision -战略决策工作流程
• legal-workflow -完整的法律案件管理
• infrastructure-deploy -Cloudflare部署
• cross-sync -设备同步
• full-orchestration -所有工具组合

路线图

v3.0.0-已完成 ✅:

• \[x\] 具有核心/工具/集成层的模块化架构
• \[x\] 动态刀具装载系统
• \[x\] 链执行框架
• \[x\] 4个领域的15多种工具
• \[x\] ChittyID集成
• \[x\] Cloudflare API集成
• \[x\] 统一和独立服务器

下一页（v3.1.0）:

• \[\]执行工具AI集成（Anthropic/OpenAI）
• \[\]ChittyLedger PostgreSQL集成
• \[\]工具模块的热重新加载
• \[\]Web API网关

未来（v4.0.0）:

• \[\]多平台同步（ChatGPT、CustomGPT）
• \[\]证据监控自动化
• \[\]高级链编排（回滚、并行执行）

______________________________________________________________________

许可证

MIT许可证-请参阅 许可证

______________________________________________________________________

支持

• 文档: CLAUDE.md 和 故障排除.md
• 问题: https://github.com/chittyos/chittymcp/issues

______________________________________________________________________

最后更新: 2025-10-30 版本: 3.0.0 ChittyOS框架：v1.0.1 MCP-SDK: 0.5.0