Neptune MCP服务器

Amazon Neptune MCP服务器,用于通过openCypher和Gremlin查询Neptune数据库和Neptune Analytics的状态、架构和执行查询。

  • by AkM-2018
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 akm-2018/tmp_amazon_neptune_mcp_server

使用说明

AWS实验室亚马逊Neptune MCP服务器

Amazon Neptune MCP服务器,允许使用openCypher和Gremlin获取状态、模式和查询Neptune数据库,使用openCyfer获取Neptune分析。

特性

Amazon Neptune MCP服务器提供以下功能:

  1. 运行查询:对配置的数据库执行openCypher和/或Gremlin查询
  2. 模式:以文本字符串的形式获取配置图中的架构
  3. 状态:查找该图对您的服务器是“可用”还是“不可用”。这有助于确保图形连接。

AWS要求

  1. AWS CLI配置:您必须为AWS CLI配置凭据和可以访问Amazon Neptune的AWS_PROFILE
  2. 亚马逊海王星:您必须至少有一个亚马逊海王星数据库或亚马逊海王星分析图。
  3. IAM权限:您的IAM角色/用户必须具有适当的权限:
    • 访问亚马逊海王星
    • 查询亚马逊海王星
  4. 访问:运行服务器的位置必须能够访问Amazon Neptune实例。Neptune数据库位于私有VPC中,因此可以访问私有VPC。Neptune Analytics可以使用公共端点进行访问(如果已配置),也可以访问私有端点。

注意:此服务器将运行发送给它的任何查询,其中可能包括变异和只读操作。正确配置角色的权限,以允许/不允许此处指定的特定数据平面操作:

先决条件

  1. 安装 uv 从 星体 或 GitHub自述
  2. 使用以下命令安装Python uv python install 3.10

安装

下面是一个如何配置MCP客户端的示例,尽管不同的客户端可能需要不同的格式。

{
  "mcpServers": {
    "Neptune Query": {
      "command": "uvx",
      "args": ["awslabs.amazon-neptune-mcp-server@latest"],
      "env": {
        "FASTMCP_LOG_LEVEL": "INFO",
        "NEPTUNE_ENDPOINT": "<INSERT NEPTUNE ENDPOINT IN FORMAT SPECIFIED BELOW>"
      }
    }
  }
}

Docker配置

建成后 docker build -t awslabs/amazon-neptune-mcp-server .:

{
  "mcpServers": {
    "awslabs.amazon-neptune-mcp-server": {
        "command": "docker",
        "args": [
          "run",
          "--rm",
          "-i",
          "awslabs/amazon-neptune-mcp-server"
        ],
        "env": {
        "FASTMCP_LOG_LEVEL": "INFO",
        "NEPTUNE_ENDPOINT": "<INSERT NEPTUNE ENDPOINT IN FORMAT SPECIFIED BELOW>"
        },
        "disabled": false,
        "autoApprove": []
    }
  }
}

指定海王星端点时,应采用以下格式:

对于Neptune数据库: neptune-db://<Cluster Endpoint>

对于Neptune Analytics: neptune-graph://<graph identifier>