Are.na MCP服务器

一个模型上下文协议服务器,让AI代理能够与Are.na平台互动,用于创意研究和知识管理。

  • by ertekinno
  • Python
  • 本地部署
  • 14 星标
  • 更新于
在 GitHub 查看 ertekinno/arena_mcp

使用说明

Are.na MCP服务器

一个模型上下文协议服务器,允许AI代理与 阿瑞娜 --创意研究和知识管理平台。为 区域.na API v3.

  • 搜索和浏览 通道、块、用户和组
  • 创建和管理 通道和块
  • 连接内容 跨渠道
  • 评论 在街区
  • 探索网络 相关内容
  • 视觉内容支持 --图像块的视觉分析

不需要API令牌 用于浏览——仅在写入操作时需要。

安装

pip install mcp httpx pydantic python-dotenv

要获得写访问权限,请添加您的Are.na令牌:

# Get one at: https://are.na/settings/personal-access-tokens
echo "ARENA_ACCESS_TOKEN=your_token_here" > .env

使用Claude Desktop进行设置

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "arena": {
      "command": "python",
      "args": ["/absolute/path/to/arena_mcp.py"]
    }
  }
}

使用Claude代码进行设置

claude mcp add arena python /absolute/path/to/arena_mcp.py

响应格式

所有工具都支持三种响应格式 response_format 参数:

格式 默认值 描述
compact 是 每个项目一行,包含所有ID。最适合代理商。
markdown 详细的多线视图。适合阅读。
json 清理JSON(默认情况下去除图像斑点)。

紧凑格式示例:

[Page 1/3 | 72 total | more: page=2]
id:12345 | Image | conn:67890 | "Architecture Photo" | https://example.com | @username
id:12346 | Text | conn:67891 | "Research Notes" | @username | [First 100 chars of content...]
id:12347 | Link | conn:67892 | "Reference Article" | https://example.com/article | @username

可用工具

搜索

  • arena_search --跨块、通道、用户、组的统一搜索。支持类型/范围/排序过滤器。

频道

  • arena_get_channel --频道元数据
  • arena_get_channel_contents --带排序的分页内容
  • arena_get_channel_connections --已连接到此频道的频道
  • arena_get_channel_followers --渠道追随者
  • arena_create_channel --创建频道
  • arena_update_channel --更新标题、可见性、描述
  • arena_delete_channel --删除频道(不可逆)

积木

  • arena_get_block --块细节,可选图像视觉支持
  • arena_get_block_comments --对某个区块的评论
  • arena_get_block_connections --包含块的通道
  • arena_create_block --创建一个块(URL或文本)并连接到频道
  • arena_update_block --更新标题、描述、内容

评论

  • arena_create_comment --对某个区块发表评论(支持@提及)
  • arena_delete_comment --删除评论

连接

  • arena_create_connection --将块或通道连接到通道
  • arena_delete_connection --删除连接
  • arena_bulk_delete_connections --一次最多删除50个连接
  • arena_move_connection --在渠道内重新订购商品

用户

  • arena_get_me --当前已通过身份验证的用户
  • arena_get_user --用户资料
  • arena_get_user_contents --用户设置的块和通道
  • arena_get_user_following --用户关注谁/什么(可按类型过滤)
  • arena_get_user_followers --用户的关注者

群组

  • arena_get_group --集团简介
  • arena_get_group_contents --按组划分的块和通道

许可证

MIT许可证——见 许可证 文件以获取详细信息。

链接