关键词

星球大战行星数据Couchbase图像生成Nebius API

Star Wars Planetary Data MCP 服务器 (mcp-nebius)

项目简介

本项目是一个 MCP 服务器，提供对星球大战行星数据的访问。它利用 Couchbase 作为数据存储，并使用 Nebius API 生成行星图像。它公开了一些工具，用于获取特定行星的详细信息，并查找具有相似特征的行星。

主要功能点

  • 获取行星数据: 根据行星名称检索星球大战行星的详细信息。
  • 查找相似行星: 基于向量嵌入发现与给定行星相似的行星。
  • 生成行星图像: 使用 Nebius AI 图像生成 API 生成星球大战行星的图像。

安装步骤

  1. 准备工作:
    • 确保已安装 Node.js 和 npm。
    • 确保 Couchbase 集群已设置并正在运行。
    • 获取 Nebius API 密钥。
  2. 克隆仓库: 
    git clone https://github.com/shivaylamba/mcp-nebius.git
cd mcp-nebius
  3. 安装依赖: 
    npm install
  4. 设置环境变量: 在项目根目录下创建一个 '.env' 文件，并设置以下环境变量： 
    COUCHBASE_URL=<您的 Couchbase 连接 URL>
COUCHBASE_USERNAME=<您的 Couchbase 用户名>
COUCHBASE_PASSWORD=<您的 Couchbase 密码>
COUCHBASE_BUCKET=<您的 Couchbase Bucket 名称>
COUCHBASE_SCOPE=<您的 Couchbase Scope 名称 (例如, _default)>
COUCHBASE_COLLECTION=<您的 Couchbase Collection 名称 (例如, _default)>
NEBIUS_API_KEY=<您的 Nebius API 密钥>
    注意: 将占位符值替换为您的实际 Couchbase 和 Nebius API 凭据。

服务器配置 (供 MCP 客户端使用)

要从 MCP 客户端连接到此 MCP 服务器，您需要使用服务器的启动命令配置客户端。由于此服务器使用 'stdio' 传输，配置应如下所示：

{
  "serverName": "starwars-server",
  "command": "node",
  "args": ["index.js"]
}

说明:

  • '"serverName"': 用于在 MCP 客户端中标识此服务器的名称。如果适用，它应与服务器声明的名称匹配。
  • '"command"': 用于启动服务器的命令。在本例中，它是 'node'，用于运行 'index.js' 文件。
  • '"args"': 传递给命令的参数数组。这里是 '["index.js"]'，用于指定服务器的入口点。

请确保 MCP 客户端执行此命令时位于项目目录 ('mcp-nebius') 中。

基本使用方法

  1. 启动服务器:

    npm start

    这将启动 MCP 服务器，监听通过标准输入/输出发送的请求。

  2. 使用 MCP 客户端连接: 配置您的 MCP 客户端以使用上面提供的配置连接到此服务器。

  3. 使用工具: 您的 MCP 客户端现在可以向服务器发送 MCP 请求，以使用公开的工具：

    • 'fetch_planet_name': 获取行星详细信息，提供行星名称作为参数。
    • 'find_planets_which_are_similar': 查找相似行星，提供行星名称作为参数。

    服务器将响应 JSON-RPC 响应，其中包含请求的数据，包括行星信息和可能的行星图像。

信息

分类

数据库与文件

访问项目