Tacit MCP

隐性mcp

连接AI助手的MCP服务器 默契 构建数字双胞胎。用自然语言询问有关建筑物、设备、传感器和区域的问题。

适用于Claude Desktop、Claude Code、Cursor、Windsurf和任何兼容MCP的客户端。

它做什么

四种只读工具：

GraphQL工具包含完整的模式引用，因此AI模型可以编写查询，而不需要单独的文档。

快速启动

选项A:npx（推荐--无需安装）

npx -y @tacit/mcp-server

只需将您的MCP客户端指向它（请参阅下面的配置）。没有克隆，就没有建筑。

选项B：克隆和构建

git clone https://github.com/ucl-sbde/tacit-mcp.git
cd tacit-mcp
npm install
npm run build

您需要一个Tacit API密钥。从您的仪表板上获取一个 app.betacit.com 在...之下 网站设置>API密钥.

连接方式

1.标准传输（本地，默认）

标准方法——MCP客户端将服务器作为子进程启动。最适合在您自己的机器上单独使用。

克劳德桌面

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）或 %APPDATA%\Claude\claude_desktop_config.json （Windows）：

{
  "mcpServers": {
    "tacit": {
      "command": "npx",
      "args": ["-y", "@tacit/mcp-server"],
      "env": {
        "TACIT_API_KEY": "your-api-key"
      }
    }
  }
}

克劳德代码

添加 .mcp.json 在您的项目中：

{
  "mcpServers": {
    "tacit": {
      "command": "npx",
      "args": ["-y", "@tacit/mcp-server"],
      "env": {
        "TACIT_API_KEY": "your-api-key"
      }
    }
  }
}

光标

添加 .cursor/mcp.json:

{
  "mcpServers": {
    "tacit": {
      "command": "npx",
      "args": ["-y", "@tacit/mcp-server"],
      "env": {
        "TACIT_API_KEY": "your-api-key"
      }
    }
  }
}

2.可流式HTTP传输（远程）

将服务器作为持久HTTP服务运行。最适合团队、云部署和用户无法在本地安装Node.js的环境。

# Start the HTTP server
TACIT_API_KEY=your-api-key npm run start:http

# Or with npx
TACIT_API_KEY=your-api-key npx --package @tacit/mcp-server tacit-mcp-http

服务器正在监听 http://0.0.0.0:3001/mcp 默认情况下。

从任何MCP客户端连接

使用承载令牌将您的客户端指向服务器URL：

{
  "mcpServers": {
    "tacit": {
      "type": "streamable-http",
      "url": "https://your-host:3001/mcp",
      "headers": {
        "Authorization": "Bearer your-api-key"
      }
    }
  }
}

HTTP配置

健康检查

GET /health → { "status": "ok", "transport": "streamable-http", "sessions": 3 }

3.OAuth 2.1（企业版）

对于您希望用户通过Tacit的登录流而不是管理API密钥进行身份验证的生产部署：

TACIT_OAUTH_ISSUER=https://app.betacit.com npm run start:http

这使得：

• 动态客户端注册 --MCP客户端自动注册
• 授权码+PKCE --用户通过Tacit的web UI登录
• 令牌刷新 --会话保持活动状态，无需重新身份验证
• 令牌撤销 --干净会话终止

支持OAuth的MCP客户端（如Claude Desktop）将通过 .well-known/oauth-authorization-server 元数据端点。

4.Docker

docker run -p 3001:3001 -e TACIT_API_KEY=your-api-key tacit/mcp-server

使用上面的HTTP传输配置进行连接。

试试看

连接后，询问您的AI助手以下问题：

• “列出我的所有建筑工地”
• “Tower West有什么空气处理机组？”
• “显示AHU-001上的温度传感器”
• “获取最近24小时的送风温度数据”
• “什么设备为大厅区域供电？”

环境变量

发展

npm run dev       # watch mode — stdio transport
npm run dev:http  # watch mode — HTTP transport
npm run build     # compile TypeScript
npm start         # run stdio transport
npm run start:http # run HTTP transport

许可证

麻省理工学院