MCP工具参考 · Aiqbee Hive

全部34个工具，按用途分组。在MCP端点上调用tools/list可获取完整的JSON schema，这是权威的接口约定，构建工具定义时应以此为准。

两条省时规则。ID无法猜测：写入前先通过aiqbee_get_neuron_types获取神经元类型ID。此外，每个工具都会以结构化JSON返回错误，并附带可据此操作的说明；请将其原样传回模型，而不是笼统地归结为“调用失败”。

搜索与读取

智能体最常调用的工具。`aiqbee_search`是语义搜索，请传入自然语言问题，而非关键词。

工具	作用
`aiqbee_search`	在Brain内对神经元进行语义搜索。
`aiqbee_fetch`	按ID获取单个神经元的完整内容。
`aiqbee_list_neurons`	分页浏览神经元，可按类型筛选。
`aiqbee_get_neuron_count`	统计神经元数量，以低开销的方式了解Brain的规模。
`aiqbee_get_brain_info`	Brain名称、描述和设置。
`aiqbee_get_relationships`	指定神经元的突触（链接）。
`aiqbee_get_neuron_types`	此Brain中可用的类型及其ID。
`aiqbee_list_neuron_types`	同一组类型，以列表形式返回。
`aiqbee_list_metadata_fields`	此Brain声明的元数据字段，即可在搜索和列表的`metadata_filter`中使用的键。
`aiqbee_edit_is_allowed`	在提供编辑操作前检查是否可写。

写入

所有写入操作都遵循Brain的allow_mcp_editing标记和调用方的访问级别。默认情况下，如果新建神经元的标题和内容与现有神经元完全相同，创建会被拒绝，并返回现有神经元，以便智能体改为更新或建立连接，避免Brain内容碎片化。只有确实需要第二份副本时，才传入allow_duplicate=true。

工具	作用
`aiqbee_create_neuron` 写入	创建神经元。
`aiqbee_update_neuron` 写入	更新神经元的标题、内容或日期。
`aiqbee_delete_neuron` 写入	删除神经元。
`aiqbee_create_relationship` 写入	用突触连接两个神经元。
`aiqbee_update_relationship` 写入	编辑突触的描述。
`aiqbee_delete_relationship` 写入	删除一个突触。
`aiqbee_update_brain` 写入	修改Brain设置。
`aiqbee_add_neuron_type` 写入	请添加神经元类型。
`aiqbee_edit_neuron_type` 写入	重命名类型或修改其描述。
`aiqbee_delete_neuron_type` 写入	删除类型，并重新分配其神经元。

访问控制

目录与授权管理。按类型授权的工具需要高级安全，这是一项付费功能，详见许可证&版本。

工具	作用
`aiqbee_list_users`	有权访问此Brain的用户。
`aiqbee_list_all_groups`	此Hive上的所有用户组。
`aiqbee_list_brain_groups`	拥有此Brain访问权限的用户组。
`aiqbee_list_all_service_accounts`	此Hive上的服务账号。
`aiqbee_list_type_access`	某个神经元类型的按类型授权。
`aiqbee_grant_access` 写入	授予用户Brain访问权限。
`aiqbee_revoke_access` 写入	撤销用户的Brain访问权限。
`aiqbee_grant_brain_group_access` 写入	授予用户组Brain访问权限。
`aiqbee_revoke_brain_group_access` 写入	撤销用户组的Brain访问权限。
`aiqbee_grant_type_access` 写入	授予单个神经元类型的访问权限。
`aiqbee_revoke_type_access` 写入	撤销对某个神经元类型的访问权限。
`aiqbee_set_neuron_type_security` 写入	让神经元启用类型级安全。

审计历史

审计日志是付费功能，需要按Brain单独开启。未开启时，这些工具会拒绝请求。

工具	作用
`aiqbee_get_audit_history`	单个神经元的变更历史。
`aiqbee_get_brain_audit_history`	整个Brain的变更历史。

选择要开放的内容

无需把全部34个工具都交给模型。工具集越大，模型越难选对工具，因此建议先从少量工具开始，确有需要时再逐步扩充：

智能体类型	推荐的工具集
基于团队知识回答问题	`aiqbee_search`, `aiqbee_fetch`
还会记录决策内容	在上述基础上增加`aiqbee_get_neuron_types`、`aiqbee_create_neuron`、`aiqbee_update_neuron`
整理并关联知识	在上述基础上增加`aiqbee_create_relationship`、`aiqbee_get_relationships`
管理Hive	访问控制类工具，通常更适合由人工在界面中操作

完全不开放删除工具是一个合理的默认选择。对话式智能体很少需要主动执行删除，而误删往往难以察觉，代价高昂。