Sample TOS Model Context Protocol Server

Sample TOS Model Context Protocol Server

site icon
2025.04.14 2
Python对象存储数据检索数据库
Sample TOS Model Context Protocol Server 是一个MCP服务器实现,用于从TOS(火山引擎对象存储)中检索数据。它通过资源暴露TOS数据,目前仅支持PDF文档,且限制在1000个对象以内。该服务提供了多种工具来管理TOS中的对象,包括列出存储桶、列出对象和获取对象等。
View on GitHub

Overview

基本能力

产品定位

Sample TOS Model Context Protocol Server 是一个用于从火山引擎对象存储(TOS)中检索数据的MCP服务器实现。

核心功能

  1. 资源暴露:通过资源暴露TOS数据,目前仅支持PDF文档,且限制在1000个对象以内。
  2. 工具列表
  3. ListBuckets:返回请求发送者拥有的所有存储桶列表。
  4. ListObjectsV2:返回存储桶中的部分或全部(最多1000个)对象。
  5. GetObject:从TOS中检索对象,支持虚拟主机风格请求和路径风格请求。

适用场景

  1. 需要从TOS中检索PDF文档的场景。
  2. 需要管理TOS存储桶和对象的场景。

使用教程

使用依赖

  1. 从火山引擎管理控制台获取访问密钥ID、秘密访问密钥和区域。
  2. 使用Default配置文件配置凭证文件。
  3. 确保这些凭证具有对TOS的适当读写权限。

安装教程

  1. 同步依赖并更新锁文件:
uv sync
  1. 构建包分发:
uv build
  1. 发布到PyPI:
uv publish

调试方式

  1. 开发/未发布服务器配置:
{
  "mcpServers": {
    "tos-mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/user/generative_ai/model_context_protocol/tos-mcp-server",
        "run",
        "tos-mcp-server"
      ]
    }
  }
}
  1. 已发布服务器配置:
{
  "mcpServers": {
    "TOS-mcp-server": {
      "command": "uvx",
      "args": [
        "tos-mcp-server"
      ]
    }
  }
}

许可证

该项目遵循 MIT-0 开源许可条款。