Syncaida MCP服务器
使用模型上下文协议(MCP)将Claude Code连接到Syncaida工作区。
特性
- 白板管理:创建、列出、更新白板
- 图表生成:使用AI创建流程图和架构图
- 任务管理:创建和管理任务
- 工作台管理:列出并创建工作板
- API令牌身份验证:使用Syncaida API令牌进行安全访问
安装
先决条件
- Node.js 18或更高版本
- 已安装克劳德代码
- Syncaida API令牌(在用户与安全>API令牌创建一个)
全球安装```bash
claude mcp add --scope user --transport stdio syncaida \
--env SYNCAIDA_API_URL="http://localhost:8052" \
--env SYNCAIDA_API_TOKEN="your-token-here" \
-- npx @scriptedventures/syncaida-mcp-server@latest
### 验证安装```bash
claude mcp list
您应该在列表中看到“syncaida”。
使用示例
创建白板```
"Create a new whiteboard called 'System Architecture'"
### 生成流程图```
"Create a flowchart on my whiteboard showing a user login process with steps:
Start -> Enter Credentials -> Validate -> Success/Failure -> End"
创建架构图```
"Draw an architecture diagram showing: Frontend (React), Backend (FastAPI),
Database (PostgreSQL), and Cache (Redis) with their connections"
### 列出任务```
"Show me all my tasks"
任务```
"Create a high priority task: Implement authentication with due date next Friday"
## 可用工具
### 白板工具
- `list_whiteboards` -列出所有白板
- `get_whiteboard` -获取白板详细信息
- `create_whiteboard` -创建新白板
- `update_whiteboard` -更新白板内容
### 图表工具
- `create_flowchart` -使用自动布局生成流程图
- `create_architecture_diagram` -创建系统架构图
### 任务工具
- `list_tasks` -列出所有任务
- `create_task` -创建新任务
- `update_task` -更新任务详细信息
### 工作板工具
- `list_workboards` -列出所有工作板
- `create_workboard` -创建新的工作板
## 配置
MCP服务器需要两个环境变量:
- `SYNCAIDA_API_URL`:您的Syncaida API URL(默认值:http://localhost:8052)
- `SYNCAIDA_API_TOKEN`:您的Syncaida API令牌(必需)
## 发展
### 本地开发```bash
git clone https://github.com/syncaida/mcp-server
cd mcp-server
npm install
npm run build
本地测试```bash
claude mcp add --scope user --transport stdio syncaida-dev \
--env SYNCAIDA_API_URL="http://localhost:8052" \
--env SYNCAIDA_API_TOKEN="your-token-here" \
-- node /path/to/syncaida-mcp-npm/dist/index.js
```
故障排除
MCP服务器未连接?
- 验证您的API令牌是否有效
- 检查一下
SYNCAIDA_API_URL指向您正在运行的Syncaida实例 - 确保克劳德代码已重新启动
权限错误?
- 确保您的API令牌具有必要的作用域
- 检查令牌是否未被撤销
许可证
麻省理工学院
支持
有关问题和疑问,请访问:https://github.com/syncaida/mcp-server/issues
