能源控制时间框架管理服务器

ECT.MCP.Server是能源-控制-时间(ECT)框架的管理服务器,提供场景和步骤管理、图形遍历汇总和赤字分类工具。

  • by gcshubert
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 gcshubert/ect-mcp-server

使用说明

发射型计算机断层扫描仪。MCP。服务器

ECT(能量-控制-时间)框架的MCP服务器。提供场景和步骤管理、图形行走汇总和赤字分类的工具——所有这些都是通过 ECT.ACC.Api 作为中介层。

先决条件

  • Node.js 18+
  • ECT.ACC.Api 在本地运行或可通过URL访问
  • ECT.Graph.Api Neo4j正在运行(ECT.ACC.Api委托给它们——MCP服务器不直接与它们通信)

设置

npm install
npm run build

环境变量

变量 必填 描述
ECT_ACC_API_URL ✅ ECT的基本URL。ACC.Api,例如。 http://localhost:5000
ECT_API_KEY 可选 如果是ECT,则为API键。ACC.Api需要身份验证

跑步

# Development (tsx, no build needed)
ECT_ACC_API_URL=http://localhost:5000 npm run dev

# Production
npm run build
ECT_ACC_API_URL=http://localhost:5000 npm start

Claude桌面配置

添加 claude_desktop_config.json:

{
  "mcpServers": {
    "ect-framework": {
      "command": "node",
      "args": ["C:/Source/ECT.MCP.Server/dist/index.js"],
      "env": {
        "ECT_ACC_API_URL": "http://localhost:5000"
      }
    }
  }
}

对于开发(无构建步骤):

{
  "mcpServers": {
    "ect-framework": {
      "command": "npx",
      "args": ["tsx", "C:/Source/ECT.MCP.Server/src/index.ts"],
      "env": {
        "ECT_ACC_API_URL": "http://localhost:5000"
      }
    }
  }
}

工具

工具 说明
create_scenario 使用模式、求解、域、系统类型创建场景
get_scenario 检索场景元数据
add_step 添加一个包含E、C、k、T、来源、聚合类型的步骤
update_step 更新步骤参数
delete_step 删除步骤和所有叶子节点
get_steps 获取包含参数值和来源标志的完整步骤树
run_rollup 执行图遍历——返回ACC类型、比率、置信度、瓶颈
get_walk_result 无需重新运行即可获取最新汇总结果

建筑

Claude Desktop
    ↓ (MCP / stdio)
ECT.MCP.Server        ← this project
    ↓ (HTTP / JSON)
ECT.ACC.Api           ← mediation layer (scenarios, hierarchical endpoints, deficit compute)
    ↓
ECT.Graph.Api         ← graph engine (Neo4j, rollup math)
    ↓
Neo4j

Track 4兼容性说明

MCP服务器已为Track 4字段做好准备(provenance, aggregateType, systemType, ACCType,比率分类)汇总结果。这些模型在 src/types/ect.types.ts 并浮出水面 run_rollup / get_walk_result 输出。如果ECT。ACC.Api尚未返回这些字段,工具将显示 — 对于这些列,不需要更改服务器代码。

本地开发启动提醒

# Terminal 1 — Neo4j
cd C:\Source\ECT.Graph.Api && docker compose up neo4j

# Terminal 2 — ECT.Graph.Api
cd C:\Source\ECT.Graph.Api && dotnet run --project src/ECT.Graph.Api

# Terminal 3 — ECT.ACC.Api
cd C:\Source\ECT.ACC && dotnet run --project ECT.ACC.Api

# Terminal 4 — This server (dev mode)
cd C:\Source\ECT.MCP.Server && npm run dev