使用说明
@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个工具）
| 工具 | 说明 |
|---|---|
nextmavens_query |
使用过滤器（eq、neq、gt、gte、lt、lte、like、ilike、in）查询数据 |
nextmavens_insert |
在表中插入新行 |
nextmavens_update |
使用筛选器更新现有行 |
nextmavens_delete |
使用筛选器删除行 |
身份验证（2个工具）
| 工具 | 说明 |
|---|---|
nextmavens_signin |
使用电子邮件和密码登录用户 |
nextmavens_signup |
使用可选名称和tenantId注册新用户 |
存储（3个工具）
| 工具 | 说明 |
|---|---|
nextmavens_file_info |
按ID获取文件元数据 |
nextmavens_file_download_url |
为文件生成下载URL |
nextmavens_list_files |
列出具有可选筛选器（tenantId、fileType）的文件 |
GraphQL（2个工具）
| 工具 | 说明 |
|---|---|
nextmavens_graphql |
执行GraphQL查询 |
nextmavens_graphql_introspect |
探索数据库架构 |
过滤器操作员
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加密
许可证
麻省理工学院
