弧服务器
- 作者仓库星标 0
- 作者仓库 skills-registry
- 领域
- 人工智能
- 作者声明的智能体
- 未找到明确声明;不据此推断已兼容或已测试
- 静态检查
- 88 / 100 · 启发式扫描,不代表运行安全
- 运行环境证据
- 未执行;当前没有隔离运行测试证据
- 作者 / 版本 / 许可证
- @tomevault-io · 未声明许可证
- 上下文用量评级
- 低消耗
- 接入复杂程度
- 需简单配置
- 是否需要外部接口密钥
- 需要 · Vendor-specific
- 兼容的系统
- macOS · Linux · Windows
- 运行环境要求
- Bun
- 检测到的文件与系统行为
-
- 只读
- 允许写入 / 修改
- 命令执行
- 网络行为
- 允许外网请求
- 安装命令数
- 无(仅作为资料)
需要注意: 未声明工具权限范围;实际权限由运行环境决定。
# mcp-server
Exposes Arc's core surfaces via the Model Context Protocol (MCP). External Claude Code instances, Cursor, or any MCP client can interact with Arc's task queue, skill tree, memory, and dispatch state.
## Architecture
- **Runtime:** Bun + `@modelcontextprotocol/sdk`
- **Transports:** stdio (local, default) or HTTP (remote, `--transport http`)
- **Auth:** API key via `--auth-key` flag or `mcp-server/auth_key` credential (HTTP only)
- **Database:** Read/write to `db/arc.sqlite` via existing `src/db.ts` functions
## Exposed Surfaces
### Tools (read-write)
| Tool | Description |
|------|-------------|
| `list_tasks` | List tasks by status/priority (default: pending + active) |
| `create_task` | Queue a new task with subject, priority, skills |
| `get_task` | Fetch task details + result by ID |
| `close_task` | Mark task completed or failed with summary |
| `list_skills` | List installed skills with metadata |
| `get_status` | Agent status: pending/active counts, costs, last cycle |
### Resources (read-only)
| Resource | URI | Description |
|----------|-----|-------------|
| Memory | `arc://memory` | Current MEMORY.md contents |
| Cycle Log | `arc://cycles` | Last 20 dispatch cycles |
## CLI
```
arc skills run --name mcp-server -- start # stdio transport (default)
arc skills run --name mcp-server -- start --transport http # HTTP on port 3100
arc skills run --name mcp-server -- start --port 3100 --auth-key KEY # custom port + auth
```
## When to Load
Load when: building or maintaining the MCP server itself, debugging connection issues, or adding new tools to the exposed surface. Do NOT load when using Arc as a dispatch agent — this skill is for managing the MCP server, not for tasks executed by external MCP clients.
## Claude Code Integration
Add to `.claude/settings.json` (external client config, not Arc's own dispatch):
```json
{
"mcpServers": {
"arc": {
"command": "bun",
"args": ["skills/arc-mcp-server/server.ts"],
"alwaysLoad": true
}
}
}
```
`alwaysLoad: true` is recommended for external clients — it ensures tools are immediately available without a ToolSearch round-trip. Do NOT add arc-mcp-server to Arc's own `.claude/settings.json`; Arc uses the `arc` CLI directly during dispatch and does not connect to its own MCP surface.
For remote HTTP:
```json
{
"mcpServers": {
"arc": {
"url": "http://localhost:3100/mcp",
"alwaysLoad": true
}
}
}
```
## Timeout Configuration
External Claude Code clients connecting via HTTP transport should set `MCP_TOOL_TIMEOUT` for long-running resource operations:
```bash
export MCP_TOOL_TIMEOUT=120000 # 120 seconds (default: 60s)
```
This is primarily relevant for large MEMORY.md reads or extended cycle log queries. Arc's native tools (list_tasks, create_task, get_status) typically complete in <5 seconds. See Claude Code v2.1.142+ release notes for details on MCP_TOOL_TIMEOUT behavior.
---
> Source: [arc0btc/arc-starter](https://github.com/arc0btc/arc-starter) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-05-23 -->
章节与文件索引
按说明文件中的顺序排列。
建筑
工具(读写)
资源(只读)
何时加载
克劳德代码集成
文件/命令 -> @modelcontextprotocol/sdk · --transport http · --auth-key · mcp-server/auth_key · db/arc.sqlite · src/db.ts · list_tasks · create_task
内容校验值 -> 686f18b4354c
当前原文的自动摘译,尚未人工审校。
建筑
运行时:Bun +
@modelcontextprotocol/sdk传输:stdio(本地,默认)或 HTTP(远程,--transport http) 身份验证:通过--auth-key标志或mcp-server/auth_key凭证的 API 密钥(仅限 HTTP) 数据库:通过现有src/db.ts函数读/写db/arc.sqlite工具(读写)
工具 · 描述
list_tasks· 按状态/优先级列出任务(默认:待处理 + 活动)create_task· 将新任务与主题、优先级、技能排队get_task· 按 ID 获取任务详细信息 + 结果close_task· 通过摘要标记任务已完成或失败资源(只读)
资源 · URI · 描述 内存 ·
arc://memory· 当前 MEMORY.md 内容 周期日志 ·arc://cycles· 最近 20 个调度周期何时加载
加载时间:构建或维护 MCP 服务器本身、调试连接问题或向暴露的表面添加新工具。使用 Arc 作为调度代理时请勿加载 - 该技能用于管理 MCP 服务器,而不是用于外部 MCP 客户端执行的任务。
克劳德代码集成
添加到
.claude/settings.json(外部客户端配置,不是 Arc 自己的调度):建议外部客户端使用alwaysLoad: true— 它确保工具立即可用,无需 ToolSearch 往返。不要将 arc-mcp-server 添加到 Arc 自己的.claude/settings.json; Arc 在调度期间直接使用arcCLI,并且不连接到其自己的 MCP 表面。对于远程 HTTP: