关键词

火山引擎 TLS日志服务集成LLM 数据源外部工具

这是一个基于 Model Context Protocol (MCP) 的服务器实现，旨在通过标准化的 MCP 接口，连接大型语言模型 (LLM) 与火山引擎 (Volcengine) 的日志服务 (TLS)。它实现了 MCP 规范中的资源和工具功能，允许 LLM 客户端通过 JSON-RPC 请求获取火山引擎 TLS 中的日志项目和日志主题信息。

注意： 此仓库已存档且不再维护。建议查阅其新的代码仓库位置以获取最新版本和支持。此处提供的信息基于此存档版本。

主要功能点

  • 资源暴露： 将火山引擎 TLS 的特定数据（如项目、主题信息）以标准化的 MCP 资源形式暴露给 LLM 客户端。
  • 工具提供： 注册 MCP 工具，封装对火山引擎 TLS API 的调用逻辑，LLM 可以通过调用这些工具查询和获取日志服务的相关数据。
  • MCP 协议支持： 使用 'mcp' 库实现 MCP 服务器功能，支持通过标准 I/O (Stdio) 等传输协议与客户端通信。

安装步骤

  1. 克隆（或下载）此存档仓库的代码。
  2. 确保您已安装 Python 环境。
  3. 安装项目所需的 Python 库。打开终端，进入仓库目录，运行以下命令： 
    pip install mcp volcengine python-dotenv
  4. 配置访问火山引擎 TLS 服务的认证信息。创建或编辑项目根目录下的 '.env' 文件，或者设置系统环境变量，包含以下信息： 
    AK=您的AccessKeyId
SK=您的AccessKeySecret
REGION=您的地域（如cn-north-4）
ENDPOINT=TLS服务的Endpoint（如tls.cn-north-4.volces.com）
TOKEN=您的SecurityToken（可选）
    请替换等号后面的值为您的实际凭证和配置。

服务器配置（供 MCP 客户端使用）

此 MCP 服务器被设计为通过标准输入/输出 (Stdio) 传输协议与客户端通信。LLM 的 MCP 客户端需要知道如何启动此服务器进程。通常，您需要在 MCP 客户端的配置中指定启动服务器的命令行指令及其参数。

例如，如果此服务器的主脚本文件是 'src/main.py'，则客户端配置中描述服务器启动的部分可能包含：

  • 'command': 用于执行脚本的命令，通常是 '"python"'。
  • 'args': 传递给命令的参数列表，通常是服务器脚本的路径，如 '["path/to/your/cloned/repo/src/main.py"]'。
  • 'transport': 使用的传输协议，应设置为 '"stdio"'。
  • 'server_name': 服务器名称，例如 '"TLS MCP Server"'。

具体的配置格式取决于您使用的 MCP 客户端库或框架。

基本使用方法

  1. 按照上述步骤完成安装和配置。
  2. 启动一个支持 MCP 协议的 LLM 客户端。
  3. 配置客户端连接到此 MCP 服务器，提供正确的 'command' 和 'args' 信息。
  4. 客户端连接并初始化成功后，可以发现服务器提供的工具（如 'describe_project_tool', 'describe_projects_tool', 'describe_topic_tool', 'describe_topics_tool'）。
  5. LLM 或客户端应用可以通过调用这些工具，并传递必要的参数（如项目 ID、主题 ID），从火山引擎 TLS 服务获取日志数据。

信息

分类

AI与计算

访问项目