使用说明
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.
