MCP服务器

为Are.na设计的图原生MCP服务器,兼容支持命令式服务器的MCP客户端(如Claude Desktop、Cursor和VS Code)。

  • by xaelophone
  • TypeScript
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 xaelophone/arena-mcp

使用说明

Are.na MCP

Are.na的图形原生MCP服务器。

与支持基于命令的服务器的任何MCP客户端兼容(例如Claude Desktop、Cursor和VS Code)。

快速入门(本地STDIO)

要求:

  • Node.js 22+
  • Are.na个人访问令牌

直接从GitHub运行(推荐):

ARENA_ACCESS_TOKEN="YOUR_TOKEN" npm exec --yes --package=github:xaelophone/arena-mcp arena-mcp

或者从本地克隆运行:

npm install
npm run build
ARENA_ACCESS_TOKEN="YOUR_TOKEN" npm run start

MCP客户端配置

通用命令模式:

{
  "mcpServers": {
    "arena": {
      "command": "npx",
      "args": ["--yes", "--package=github:xaelophone/arena-mcp", "arena-mcp"],
      "env": {
        "ARENA_ACCESS_TOKEN": "YOUR_TOKEN"
      }
    }
  }
}

客户端特定设置:

已知问题和解决方法

  • search_arena 可能击中 403 在高级门控上下文的v3端点上。默认情况下,服务器在以下情况下通过v2重试 ARENA_ENABLE_V2_SEARCH_FALLBACK=true.
  • 远程HTTP客户端必须发送 Accept: application/json, text/event-stream 在MCP初始化期间,或者您可以 406 Not Acceptable.
  • HTTP模式返回时缺少/无效的身份验证密钥 401 Unauthorized 上 /mcp.

详细信息和故障排除:

文档

从这里开始:

核心参考文献:

验证

npm run docs:check
npm run lint
npm run typecheck
npm test
npm run build

STDIO烟雾测试(需要真实令牌):

ARENA_ACCESS_TOKEN="YOUR_TOKEN" npm run build && npm run smoke:stdio

着陆页

npm run landing

打开 http://localhost:4173.