Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

agent-nexus (anxc / anxs)

Channel ↔ Provider hub:用 MCP 驱动本地 Cursor Agent。

二进制 角色
anxc 轻量 MCP 客户端:IDE stdio ↔ 远端 Streamable HTTP
anxs MCP 服务端(Hub + Cursor via cursor-sdk-bridge);默认 HTTP,--stdio 单机直连

Repo: https://github.com/Slothtron/agent-nexus

安装并配置(给 AI Agent)

帮我安装并配置 anxc:https://github.com/Slothtron/agent-nexus/blob/master/docs/agent-install-anxc.md
帮我安装并配置 anxs:https://github.com/Slothtron/agent-nexus/blob/master/docs/agent-install-anxs.md

人工阅读:anxc · anxs · 索引:docs/agent-mcp-integration.md · 工具 skill:skills/anx-mcp/(安装文档中为可选步骤)

安装二进制

客户端与服务端可单独安装(GitHub Releases):

# 仅客户端(Cursor MCP)
curl -fsSL https://raw.githubusercontent.com/Slothtron/agent-nexus/master/scripts/install-anxc.sh | sh

# 仅服务端(常驻枢纽;默认不装 bridge)
curl -fsSL https://raw.githubusercontent.com/Slothtron/agent-nexus/master/scripts/install-anxs.sh | sh

# Cursor SDK bridge(anxs Cursor provider 依赖)
curl -fsSL https://raw.githubusercontent.com/Slothtron/agent-nexus/master/scripts/install-cursor-sdk-bridge.sh | sh

# 或安装 anxs 时 opt-in 一并装 bridge:
INSTALL_BRIDGE=1 curl -fsSL https://raw.githubusercontent.com/Slothtron/agent-nexus/master/scripts/install-anxs.sh | sh

可选:VERSION=v0.4.0(anxs/anxc)、VERSION=v1.0.27(bridge)、INSTALL_DIR=~/.local/bin、BRIDGE_VERSION=…(随 INSTALL_BRIDGE=1 透传)。

步骤与手动安装见 docs/deploy.md。

Requirements

  • 预编译二进制:无需 Node / cargo(用户侧)
  • 开发:Rust(.mise.toml 钉版本)+ mise
  • 运行 anxs:CURSOR_API_KEY,以及本机 cursor-sdk-bridge(安装方式见 docs/deploy.md;PATH 或 CURSOR_SDK_BRIDGE_BIN)

Build(开发)

mise trust
mise install
mise run build
mise run test
# 或: mise exec -- cargo build -p anx-client -p anx-server --release

CLI

anxs(服务端)

调用 含义
anxs / anxs --listen … HTTP MCP 常驻(默认 127.0.0.1:8787)
anxs --stdio stdio MCP(IDE 单机;与 --listen / --mcp-path / --auth-token 互斥)
export CURSOR_API_KEY=...
export ANX_TOKEN=dev-token   # optional but recommended

anxs \
  --listen 127.0.0.1:8787 \
  --workspace "$PWD" \
  --workspace /path/to/other/repo \
  --auth-token "$ANX_TOKEN"

--workspace 可重复或逗号分隔(ANX_WORKSPACE 同理);第一项为默认 cwd。不在白名单内的路径禁止执行消息命令。

anxc(客户端 bridge)

anxc --remote http://127.0.0.1:8787/mcp \
  --header "Authorization: Bearer ${ANX_TOKEN}"

推荐拓扑

IDE ──stdio──▶ anxc --remote ──HTTP──▶ anxs

单机直连(不经 anxc):

IDE ──stdio──▶ anxs --stdio

部署

Homelab / 本机常驻、环境变量与 systemd 见 docs/deploy.md。

Roadmap

  • 飞书 / IM Channel(本阶段未实现)
  • 更多 Provider

License

MIT

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages