fix(mcp): active view metadata disagrees with the view list recommendation

未關閉
#8,718 0 則留言 0 個 reaction 已指派 0 人 在 GitHub 檢視

維護者通常 2 天內回覆

還沒有人認領這個 Issue。

評估

難度
4/5
預估耗時
3-5 天
新手友好度
48/100
Issue 類型
缺陷
描述清晰度
描述清楚
活躍度
活躍
技術堆疊
cpp
領域
api

研究方向

The report identifies bn_binary_view_list, bn_binary_view_get_active, and the view-selection reply as the affected entry points; it says their implementation ships inside the proprietary application. Start by tracing the public MCP tool declarations and any shared view metadata serialization in the repository. Done means the same unchanged active view has consistent recommendation metadata across all three replies, or the replies document distinct semantics without contradictory booleans.

由索引模型根據 Issue 內容生成。

描述

Summary

For the same active Mach-O view with no intervening state change, bn_binary_view_list reports recommended: true, while bn_binary_view_get_active reports recommended: false. Clients therefore receive conflicting metadata for one view. The inconsistency also appears in the view-selection reply.

Steps to reproduce

  1. Save the C source below as fixture.c, compile it, and open fixture in Binary Ninja. Enable and start the built-in GUI MCP server, then connect an MCP client and run tools/list.
#include <stdio.h>
volatile int fixture_global = 7;
__attribute__((noinline, used)) int fixture_leaf(int value) { puts("FIXTURE_LEAF"); return value + fixture_global; }
__attribute__((noinline, used)) int fixture_branch(int value) { return value > 3 ? fixture_leaf(value) : fixture_leaf(-value); }
int main(int argc, char **argv) { return fixture_branch(argc); }
clang -arch arm64 -O0 -g -fno-inline fixture.c -o fixture
  1. Call bn_binary_view_list, select the returned Mach-O view with bn_binary_view_set_active, and wait until bn_analysis_status reports IdleState. Use the returned handle unchanged; handle values are session-scoped.

  2. Call bn_binary_view_list and immediately call bn_binary_view_get_active, with no intervening tool call or GUI action. Compare recommended for the same returned Mach-O view handle. Repeat the pair if desired.

  3. Inspect the binaryView object returned by the view-selection call as well.

Expected behavior

The guide says to use the recommended field from the view list when choosing a view. When another tool returns the same named property on that same view, it should agree, or the contract should explicitly describe a different meaning or an unavailable value. The stable and default-branch guides describe no alternate meaning for the active-view property.

Actual behavior

Two consecutive list/get-active pairs reproduced the mismatch after analysis was idle. The following projection omits opaque handles; the handle and open-item identity matched across each pair.

tool viewType created active available recommended
bn_binary_view_list Mach-O true true true true
bn_binary_view_get_active Mach-O true true true false

The get-active result carried recommended: false in both its JSON text and structuredContent.binaryView. The view-selection result also carried recommended: false. No view creation, analysis mutation, file switch, or GUI action occurred between each list/get-active pair. View selection and inspection still worked; no analysis failure was observed.

Evidence

  • Expected source: The guide's “Handles” section directs clients to the list's recommended property; installed active-view tools return a same-named property on the same view object. Versioned guide links appear under Runtime or environment.
  • Failure source: Direct consecutive raw HTTP replies from the view-list and get-active tools, plus the earlier view-selection reply; relevant fields are projected above.
  • Evidence provenance: observed
  • Local verification: reproduced
  • Reproduction completeness: complete

Restoration check

For one unchanged active view, compare the same view's recommendation across list, get-active, and set-active responses. The replies should agree on the recommendation, or explicitly represent and document any different semantics without presenting a contradictory boolean as the same metadata.

Runtime or environment

  • Binary Ninja Version: Free 6.0.10905-Stable; bundle version 6.0.10905_free; built-in GUI HTTP MCP server binaryninja_ui_mcp version 0.1.0.
  • Edition: Free. OS: macOS 27.2; CPU architecture: arm64. Target: thin arm64 Mach-O built with the command above. Analysis status was IdleState before the observations.
  • The official stable release metadata matched the installed build. A fresh profile enabled ui.mcp.enabled; no user plugins or existing databases were involved. The target was analyzed, never executed, and no database was saved.
  • The stable MCP guide and the current default-branch MCP guide were compared. Their relevant calling conventions agree. The implementation ships inside the proprietary application, so public default-branch source inspection does not verify its runtime behavior.
  • The issue template requests development-build testing. That was not performed: Free cannot switch to the development channel. Personal/Commercial editions, development builds, Windows, and Linux are untested.

Triage assessment

  • Impact level: P2
  • Assessment status: supported
  • Impact basis: The same view exposes contradictory selection metadata to MCP clients. The observed failure is bounded to metadata; view selection and function inspection succeeded.
  • Workaround status: available
  • Workaround basis: Use the list tool's recommendation as the guide instructs. That tool returned a usable Mach-O view and selecting it allowed successful inspection in this reproduction.
主要語言
C++
星號
1.3k
分支
304
平均合併
2 天 20 小時
30 天內合併 PR
10

環境準備

這個專案沒有提供開發容器、Dockerfile 或貢獻指南,環境需要你自己搭建:先看它的 README,通用步驟見我們的新手貢獻指南。

從這裡開始

  1. 先讀完整個 Issue,再讀專案的貢獻指南。
  2. 在 Issue 下留言說明你要接手 —— 這能避免兩個人做同樣的事。
  3. Fork 儲存庫,在一個分支上完成修改。
  4. 送出 Pull Request,並在描述裡引用這個 Issue 編號。

Vector35/binaryninja-api 的其他 Issue

查看 Vector35/binaryninja-api 的全部 Issue

相似的 Issue

更多 C++ Issue

把新 issue 寄到你的電子郵件信箱

精選適合新手參與的 GitHub issue 摘要。