Nextmavens MCP Server

@nextmavens/mcp服务器

NextMavens平台的模型上下文协议（MCP）服务器-使AI助手（Claude、Cursor、Continue.dev等）能够直接与您的NextMaven后端交互。

快速开始

MCP服务器可作为托管HTTP端点使用。无需安装！

只需从 下一篇Maven开发者门户 并配置您的AI工具。

特性

• 数据库操作：查询、插入、更新和删除数据
• 认证：注册并登录用户
• 存储：获取文件信息、下载URL和列出文件
• 图查询语言：执行GraphQL查询并内省架构
• 11 MCP工具 按服务类别组织

配置

将API密钥设置为环境变量：

export NEXTMAVENS_API_KEY=nm_live_pk_your_key_here

安装

选项1：托管HTTP端点（推荐）

MCP服务器位于： https://api.nextmavens.cloud/mcp

克劳德代码

claude mcp add --transport http nextmavens \
  --url https://api.nextmavens.cloud/mcp \
  --header "Authorization: Bearer $NEXTMAVENS_API_KEY"

光标（IDE）

创建 .cursor/mcp.json 在您的项目中：

{
  "mcpServers": {
    "nextmavens": {
      "type": "http",
      "url": "https://api.nextmavens.cloud/mcp",
      "headers": {
        "Authorization": "Bearer ${env:NEXTMAVENS_API_KEY}"
      }
    }
  }
}

然后设置API密钥：

export NEXTMAVENS_API_KEY=nm_live_pk_your_key_here

选项2：本地开发服务器

对于本地开发，您可以在本地运行MCP服务器：

# Clone repository
git clone https://github.com/Mkid095/nextmavens-mcp-server.git
cd nextmavens-mcp-server

# Install dependencies
npm install

# Build
npm run build

# Run with your API key
NEXTMAVENS_API_KEY=your_key npm start

然后使用本地URL进行配置： http://localhost:3000/mcp

可用工具

数据库操作（4个工具）

身份验证（2个工具）

存储（3个工具）

GraphQL（2个工具）

过滤器操作员

• eq：等于
• neq：不相等
• gt：大于
• gte：大于或等于
• lt：小于
• lte：小于或等于
• like：LIKE（区分大小写）
• ilike：ILIKE（不区分大小写）
• in：IN阵列

示例用法

数据库查询

You: "Show me all users created in the last 7 days"

Claude: Uses nextmavens_query with filters
{
  "table": "users",
  "filters": [
    { "column": "created_at", "operator": "gte", "value": "2024-01-20" }
  ],
  "orderBy": { "column": "created_at", "ascending": false }
}

创建数据

You: "Create a new post for user 123"

Claude: Uses nextmavens_insert
{
  "table": "posts",
  "data": {
    "title": "New Post",
    "content": "Post content",
    "user_id": 123
  }
}

GraphQL反思

You: "What tables are available in my database?"

Claude: Uses nextmavens_graphql_introspect to retrieve schema

测试您的设置

测试端点是否可访问：

curl https://api.nextmavens.cloud/mcp

测试MCP工具/清单：

curl -X POST https://api.nextmavens.cloud/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer nm_live_pk_your_key_here" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": {}
  }'

在克劳德代码中验证：

claude mcp list
claude mcp get nextmavens

故障排除

“服务器未启动”

• 确保已设置NEXTMAVENS_API_KEY环境变量
• 从portal.nextmavens.cloud的仪表板获取API密钥

“工具未出现在Claude代码中”

• 跑 claude mcp list 验证服务器是否已配置
• 尝试删除并重新添加： claude mcp remove nextmavens 然后重新添加

“身份验证错误”

• 验证您的API密钥是否有效以及是否具有正确的权限
• 如果需要，从仪表板获取新密钥

“网络连接问题”

• 检查您是否可以联系到 https://api.nextmavens.cloud/mcp
• 验证没有防火墙阻止连接

安全

• 始终使用公钥(nm_live_pk_*)用于客户端操作
• 保留密钥(nm_live_sk_*)安全，永远不要暴露它们
• MCP服务器需要对所有操作进行API密钥验证
• 所有流量都通过HTTPS加密

许可证

麻省理工学院

链接

• 开发者门户
• 文档

-