AI导哈

TMDB电影数据库MCP服务器

一个基于MCP协议的自定义服务器，用于从TMDB获取演员和电影信息。

  • by theREDspace
  • Rust
  • 本地部署
  • 更新于
在 GitHub 查看 theREDspace/mcp-server-example

使用说明

TMDB MCP服务器示例

此示例MCP服务器演示了如何使用MCP协议创建自定义MCP服务器并添加自己的工具。

要使用此示例，您需要一个TMDB API访问令牌。服务器连接到 电影数据库（TMDB） 以获取详细的演员和电影信息。确保您已准备好有效的TMDB API令牌，因为这是服务器正常运行所必需的。

特性

此MCP服务器提供了两个与电影数据库（TMDB）交互的简单工具：

  • get_cor_info：
    允许您按姓名搜索演员，并检索详细信息，如他们的传记、出生日期和地点等。

  • get_movies_by_actor：
    允许您通过提供特定演员的TMDB ID来检索与该演员关联的电影列表。

先决条件

这个项目是用Rust编写的，使用 铁锈mcp sdk 图书馆。
Cargo是Rust的包管理器和构建工具，是构建和运行项目所必需的。

1.安装铁锈和货物

  • Windows/Mac/Linux：
    访问 https://rustup.rs/ 并按照说明下载并运行安装程序。

  • 安装后，重新启动终端并检查是否安装了Rust和Cargo：

    rustc --version
cargo --version

2.获取TMDB API代币

  • 注册一个免费帐户 TMDB.
  • 转到您的帐户设置→ API → 请求API密钥。
  • 一旦您拥有了API密钥（令牌），请将其放在方便的位置，以便下一步使用。

建设项目

  1. 克隆或下载存储库

    如果你有Git：

    git clone https://github.com/theREDspace/mcp-server-example.git
cd mcp-server-example/techshare-mcp

    或者，从GitHub下载ZIP并解压，然后在 techshare-mcp 文件夹。

  2. 构建项目

    在 techshare-mcp 目录，运行：

    cargo build --release

    这将下载依赖项并编译项目。
    编译后的二进制文件将位于 target/release/techshare-mcp.

与MCP检查器或云桌面一起使用

MCP 检查员

  1. 安装并启动 MCP 检查员 通过运行：
  npx -y @modelcontextprotocol/inspector@latest
  1. MCP检查器将在浏览器中打开。
  2. 选择 STDIO 作为“传输类型”，并在“命令”文本框中输入编译的二进制路径。
  3. 设置 TMDB_TOKEN “环境变量”部分中的环境变量。
  4. 点击“连接”。
  5. 连接后，您将看到可用的工具，并可以根据需要调用它们。

云桌面

故障排除

  • 缺少TMDB令牌：
    如果您看到以下错误 TMDB_TOKEN must be set in environment，请确保在运行服务器之前设置了环境变量。

  • 构建错误：
    确保Rust和Cargo已安装并保持最新状态。跑 rustup update 如果需要的话。

  • 无法从MCP检查器/云桌面连接：
    仔细检查二进制文件的路径。

项目结构

  • src/main.rs --入口点，设置服务器。
  • src/mcp_handler.rs --处理传入的MCP请求。
  • src/tools/ --包含工具定义，并使用 tmdb_client.
  • src/tmdb_client.rs -与TMDB API沟通。

详细信息

许可证

该项目用于教育和示范目的。

相关 MCP