|
wxMaxima
|
Implements the read-only "worksheet context" tools the MCP server exposes to an external AI tool (GH request: "a de facto standard [MCP] AI sidebar that ... gives it access to a worksheet"). More...
#include <McpTools.h>
Public Member Functions | |
| McpTools (Worksheet *worksheet, Variablespane *variablesPane) | |
| nlohmann::json | ListTools () const |
| The tools/list result: name/description/inputSchema for every tool below. | |
| nlohmann::json | CallTool (const wxString &name, const nlohmann::json &arguments) const |
| Dispatches one tools/call request by tool name. Throws McpToolError. | |
| nlohmann::json | ListCells () const |
| nlohmann::json | ReadCell (const nlohmann::json &arguments) const |
| nlohmann::json | ReadWorksheet () const |
| nlohmann::json | ReadToc () const |
| nlohmann::json | ReadSection (const nlohmann::json &arguments) const |
| nlohmann::json | ReadVariables () const |
| nlohmann::json | WatchVariable (const nlohmann::json &arguments) const |
| nlohmann::json | UnwatchVariable (const nlohmann::json &arguments) const |
| nlohmann::json | SearchCells (const nlohmann::json &arguments) const |
Finds every cell whose input and/or output contains pattern (a plain substring by default, or a regular expression with "regex":true), so an AI can jump straight to the relevant cell(s) of a large worksheet instead of reading everything via read_worksheet/list_cells. Read-only, same as every other tool here – it never touches worksheet content. | |
Static Public Attributes | |
| static constexpr std::size_t | MAX_TEXT_LENGTH = 200000 |
| A cap on how much text a single response ever carries (read_worksheet/ read_section), so a huge worksheet can't produce an unbounded reply. | |
| static constexpr std::size_t | MAX_SEARCH_MATCHES = 50 |
| search_cells stops collecting further matches once it hits this many, reporting "truncated" instead – a pathological pattern matching most of a huge worksheet must not turn into an unbounded response either. | |
| static constexpr std::size_t | OUTPUT_PREVIEW_LENGTH = 2000 |
| The cap applied to each individual cell's own output when it's one of many being concatenated (ReadWorksheet/ReadSection) – keeps one cell with a huge output (a large matrix, a long list, ...) from crowding out every other cell's info in the same response. read_cell, which targets exactly one cell the caller already chose, is not limited to this – see its output_length/output_from_end arguments. | |
Implements the read-only "worksheet context" tools the MCP server exposes to an external AI tool (GH request: "a de facto standard [MCP] AI sidebar that ... gives it access to a worksheet").
Every tool here only reads the worksheet, with two narrow exceptions that the maintainer explicitly scoped in as safe: watch_variable/unwatch_variable only change what the Variables sidebar happens to be tracking for display, the same as a user typing a name into that sidebar by hand – they never touch worksheet content, insert/edit/evaluate anything, or have any side effect Maxima itself would notice beyond the pre-existing "query this variable's value" flow the sidebar already triggers on its own schedule. Every other tool cannot mutate anything even in principle: turning a worksheet or a cell into text is all they do. This split is deliberate product scope (confirmed with the maintainer), not an oversight – a write-capable "insert/edit/evaluate" tool surface is a different, far higher-stakes feature this first pass does not implement.
Deliberately free of any networking/JSON-RPC framing (that's McpServer's job) so this can be unit-tested directly against a real, headless Worksheet/Variablespane – see test/unit_tests/test_McpTools.cpp.
Thread safety: none of this is thread-safe, same as every other class that touches a Worksheet/GroupCell/Variablespane. McpServer only ever calls into this from the GUI thread's own event loop (its wxSocketServer runs event-driven on that thread, not on a worker thread), so no locking is needed here – keep it that way if McpServer's transport ever changes.
1.9.6