Jonas Devlieghere 9524bfb270
[lldb] Add Model Context Protocol (MCP) support to LLDB (#143628)
This PR adds an MCP (Model Context Protocol ) server to LLDB. For
motivation and background, please refer to the corresponding RFC:
https://discourse.llvm.org/t/rfc-adding-mcp-support-to-lldb/86798

I implemented this as a new kind of plugin. The idea is that we could
support multiple protocol servers (e.g. if we want to support DAP from
within LLDB). This also introduces a corresponding top-level command
(`protocol-server`) with two subcommands to `start` and `stop` the
server.

```
(lldb) protocol-server start MCP tcp://localhost:1234
MCP server started with connection listeners: connection://[::1]:1234, connection://[127.0.0.1]:1234
```

The MCP sever supports one tool (`lldb_command`) which executes a
command, but can easily be extended with more commands.
2025-06-20 10:48:04 -05:00

74 lines
2.5 KiB
C++

//===- TestUtilities.h ------------------------------------------*- C++ -*-===//
//
// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
// See https://llvm.org/LICENSE.txt for license information.
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
//
//===----------------------------------------------------------------------===//
#ifndef LLDB_UNITTESTS_TESTINGSUPPORT_TESTUTILITIES_H
#define LLDB_UNITTESTS_TESTINGSUPPORT_TESTUTILITIES_H
#include "lldb/Core/ModuleSpec.h"
#include "lldb/Utility/DataBuffer.h"
#include "llvm/ADT/SmallString.h"
#include "llvm/ADT/Twine.h"
#include "llvm/Support/Error.h"
#include "llvm/Support/FileSystem.h"
#include "llvm/Support/FileUtilities.h"
#include <string>
#define ASSERT_NO_ERROR(x) \
if (std::error_code ASSERT_NO_ERROR_ec = x) { \
llvm::SmallString<128> MessageStorage; \
llvm::raw_svector_ostream Message(MessageStorage); \
Message << #x ": did not return errc::success.\n" \
<< "error number: " << ASSERT_NO_ERROR_ec.value() << "\n" \
<< "error message: " << ASSERT_NO_ERROR_ec.message() << "\n"; \
GTEST_FATAL_FAILURE_(MessageStorage.c_str()); \
} else { \
}
namespace lldb_private {
std::string GetInputFilePath(const llvm::Twine &name);
class TestUtilities {
public:
static std::once_flag g_debugger_initialize_flag;
};
class TestFile {
public:
static llvm::Expected<TestFile> fromYaml(llvm::StringRef Yaml);
static llvm::Expected<TestFile> fromYamlFile(const llvm::Twine &Name);
ModuleSpec moduleSpec() {
return ModuleSpec(FileSpec(), UUID(), dataBuffer());
}
llvm::Expected<llvm::sys::fs::TempFile> writeToTemporaryFile();
private:
TestFile(std::string &&Buffer) : Buffer(std::move(Buffer)) {}
lldb::DataBufferSP dataBuffer() {
auto *Data = reinterpret_cast<const uint8_t *>(Buffer.data());
return std::make_shared<DataBufferUnowned>(const_cast<uint8_t *>(Data),
Buffer.size());
}
std::string Buffer;
};
template <typename T> static llvm::Expected<T> roundtripJSON(const T &input) {
llvm::json::Value value = toJSON(input);
llvm::json::Path::Root root;
T output;
if (!fromJSON(value, output, root))
return root.getError();
return output;
}
} // namespace lldb_private
#endif