feat(mcp): add agent-friendly query capabilities
Add get_mcp_capabilities so remote agents can discover enabled tool groups and preferred entrypoints. Add ask_wiki as a one-call query wrapper with structured result fields while keeping the legacy answer field for compatibility. Update MCP startup guidance and docs, and cover the new query/capability behavior with tests.
This commit is contained in:
@@ -416,12 +416,14 @@ class RemoteMcpServerTests(unittest.TestCase):
|
||||
self.assertIn("search_file_assets", FakeMCP.tool_names)
|
||||
self.assertIn("list_file_assets", FakeMCP.tool_names)
|
||||
self.assertIn("get_file_asset_metadata", FakeMCP.tool_names)
|
||||
self.assertIn("get_mcp_capabilities", FakeMCP.tool_names)
|
||||
self.assertIn("how_to_use_wiki_file_assets", FakeMCP.prompt_names)
|
||||
self.assertNotIn("create_ingest_upload", FakeMCP.tool_names)
|
||||
|
||||
def test_create_server_registers_ingest_tools_when_enabled(self):
|
||||
class FakeMCP:
|
||||
tool_names = []
|
||||
tools = {}
|
||||
|
||||
def __init__(self, _name, **_kwargs):
|
||||
pass
|
||||
@@ -429,6 +431,7 @@ class RemoteMcpServerTests(unittest.TestCase):
|
||||
def tool(self):
|
||||
def decorator(func):
|
||||
self.tool_names.append(func.__name__)
|
||||
self.tools[func.__name__] = func
|
||||
return func
|
||||
|
||||
return decorator
|
||||
@@ -474,6 +477,7 @@ class RemoteMcpServerTests(unittest.TestCase):
|
||||
def test_create_server_registers_query_tools_only_when_enabled(self):
|
||||
class FakeMCP:
|
||||
tool_names = []
|
||||
tools = {}
|
||||
|
||||
def __init__(self, _name, **_kwargs):
|
||||
pass
|
||||
@@ -481,6 +485,7 @@ class RemoteMcpServerTests(unittest.TestCase):
|
||||
def tool(self):
|
||||
def decorator(func):
|
||||
self.tool_names.append(func.__name__)
|
||||
self.tools[func.__name__] = func
|
||||
return func
|
||||
|
||||
return decorator
|
||||
@@ -498,6 +503,16 @@ class RemoteMcpServerTests(unittest.TestCase):
|
||||
return decorator
|
||||
|
||||
class FakeQueryManager:
|
||||
def ask_wiki(self, query, mode="normal", public_only=False, note=None, timeout_seconds=90, poll_interval_seconds=2):
|
||||
return {
|
||||
"job_id": "query-job",
|
||||
"state": "succeeded",
|
||||
"answer": "answer",
|
||||
"answer_markdown": "answer",
|
||||
"citations": [],
|
||||
"warnings": [],
|
||||
}
|
||||
|
||||
def start_query_job(self, query, mode="normal", public_only=False, note=None):
|
||||
return {"job_id": "query-job", "state": "queued"}
|
||||
|
||||
@@ -532,11 +547,89 @@ class RemoteMcpServerTests(unittest.TestCase):
|
||||
self.assertIsInstance(disabled_server, FakeMCP)
|
||||
self.assertIsInstance(enabled_server, FakeMCP)
|
||||
self.assertNotIn("start_wiki_query", disabled_tool_names)
|
||||
self.assertNotIn("ask_wiki", disabled_tool_names)
|
||||
self.assertIn("ask_wiki", FakeMCP.tool_names)
|
||||
self.assertIn("start_wiki_query", FakeMCP.tool_names)
|
||||
self.assertIn("get_wiki_query_status", FakeMCP.tool_names)
|
||||
self.assertIn("get_wiki_query_result", FakeMCP.tool_names)
|
||||
self.assertIn("cancel_wiki_query", FakeMCP.tool_names)
|
||||
self.assertIn("check_query_opencode_readiness", FakeMCP.tool_names)
|
||||
self.assertEqual(
|
||||
FakeMCP.tools["ask_wiki"]("what do I know?", timeout_seconds=3, poll_interval_seconds=1)["answer_markdown"],
|
||||
"answer",
|
||||
)
|
||||
|
||||
def test_get_mcp_capabilities_reports_agent_facing_tools_without_local_paths(self):
|
||||
class FakeMCP:
|
||||
tools = {}
|
||||
|
||||
def __init__(self, _name, **_kwargs):
|
||||
pass
|
||||
|
||||
def tool(self):
|
||||
def decorator(func):
|
||||
self.tools[func.__name__] = func
|
||||
return func
|
||||
|
||||
return decorator
|
||||
|
||||
def resource(self, *_args, **_kwargs):
|
||||
def decorator(func):
|
||||
return func
|
||||
|
||||
return decorator
|
||||
|
||||
def prompt(self, *_args, **_kwargs):
|
||||
def decorator(func):
|
||||
return func
|
||||
|
||||
return decorator
|
||||
|
||||
with (
|
||||
tempfile.TemporaryDirectory() as tmp,
|
||||
patch.dict("sys.modules", {"mcp.server.fastmcp": type("Mod", (), {"FastMCP": FakeMCP})()}),
|
||||
):
|
||||
root = Path(tmp)
|
||||
mcp_server.create_server(
|
||||
vault_path=root / "vault",
|
||||
enable_ingest=True,
|
||||
enable_query=True,
|
||||
project_root=root / "project",
|
||||
ingest_runtime_root=root / "ingest-runtime",
|
||||
query_runtime_root=root / "query-runtime",
|
||||
ingest_manager=IngestManager(
|
||||
vault_path=root / "vault",
|
||||
project_root=root / "project",
|
||||
runtime_root=root / "fake-ingest",
|
||||
),
|
||||
query_manager=type(
|
||||
"FakeQueryManager",
|
||||
(),
|
||||
{
|
||||
"ask_wiki": lambda self, query, mode="normal", public_only=False, note=None, timeout_seconds=90, poll_interval_seconds=2: {},
|
||||
"start_query_job": lambda self, query, mode="normal", public_only=False, note=None: {},
|
||||
"get_query_job_status": lambda self, job_id: {},
|
||||
"get_query_job_result": lambda self, job_id: {},
|
||||
"cancel_query_job": lambda self, job_id: {},
|
||||
"check_opencode_readiness": lambda self, run_smoke_test=False: {},
|
||||
},
|
||||
)(),
|
||||
)
|
||||
capabilities = FakeMCP.tools["get_mcp_capabilities"]()
|
||||
|
||||
self.assertEqual(capabilities["server_name"], "wiki-file-assets")
|
||||
self.assertEqual(capabilities["enabled_tools"], ["file-assets", "ingest", "query"])
|
||||
self.assertTrue(capabilities["query"]["enabled"])
|
||||
self.assertEqual(capabilities["query"]["preferred_tool"], "ask_wiki")
|
||||
self.assertIn("ask_wiki", capabilities["query"]["tools"])
|
||||
self.assertTrue(capabilities["ingest"]["enabled"])
|
||||
self.assertEqual(capabilities["ingest"]["http_upload_path"], "/mcp-ingest/uploads")
|
||||
self.assertEqual(capabilities["ingest"]["preferred_text_tool"], "ingest_text_note")
|
||||
self.assertIn("search_file_assets", capabilities["file_assets"]["tools"])
|
||||
self.assertNotIn("vault_path", json.dumps(capabilities))
|
||||
self.assertNotIn("runtime", json.dumps(capabilities).lower())
|
||||
self.assertNotIn("Bearer ", json.dumps(capabilities))
|
||||
self.assertNotIn("upload_token", json.dumps(capabilities))
|
||||
|
||||
def test_file_index_status_reports_opencode_model_settings(self):
|
||||
class FakeMCP:
|
||||
@@ -589,6 +682,7 @@ class RemoteMcpServerTests(unittest.TestCase):
|
||||
"FakeQueryManager",
|
||||
(),
|
||||
{
|
||||
"ask_wiki": lambda self, query, mode="normal", public_only=False, note=None, timeout_seconds=90, poll_interval_seconds=2: {},
|
||||
"start_query_job": lambda self, query, mode="normal", public_only=False, note=None: {},
|
||||
"get_query_job_status": lambda self, job_id: {},
|
||||
"get_query_job_result": lambda self, job_id: {},
|
||||
|
||||
Reference in New Issue
Block a user