mcp图形库
](https://smithery.ai/server/mcp-graphql)
一个模型上下文协议服务器,使LLM能够与GraphQL API交互。此实现提供了模式自检和查询执行功能,允许模型动态发现和使用GraphQL API。
用法
跑 mcp-graphql 使用正确的端点,它将自动尝试反思您的查询。
命令行参数
| 参数 | 描述 | 默认值 |
|---|---|---|
--endpoint | GraphQL端点URL | http://localhost:4000/graphql |
--headers | 包含请求标头的JSON字符串 | {} |
--enable-mutations | 启用变异操作(默认禁用) | false |
--name | MCP服务器的名称 | mcp-graphql |
--schema | 本地GraphQL架构文件的路径(可选) | - |
例子
# Basic usage with a local GraphQL server
npx mcp-graphql --endpoint http://localhost:3000/graphql
# Using with custom headers
npx mcp-graphql --endpoint https://api.example.com/graphql --headers '{"Authorization":"Bearer token123"}'
# Enable mutation operations
npx mcp-graphql --endpoint http://localhost:3000/graphql --enable-mutations
# Using a local schema file instead of introspection
npx mcp-graphql --endpoint http://localhost:3000/graphql --schema ./schema.graphql可用工具
服务器提供两个主要工具:
- 内省模式:此工具检索GraphQL模式。如果您没有将架构作为资源访问的权限,请先使用此选项。
这使用本地模式文件或自省查询。
- 查询图形库:对端点执行GraphQL查询。默认情况下,突变被禁用,除非
--enable-mutations已指定。
资源
- graphql模式:服务器将GraphQL模式作为客户端可以访问的资源公开。这要么是本地模式文件,要么基于内省查询。
安装
通过Smithery安装
通过以下方式自动安装GraphQL MCP Toolkit for Claude Desktop 史密瑟里:
npx -y @smithery/cli install mcp-graphql --client claude手动安装
它可以手动安装到Claude:
{
"mcpServers": {
"mcp-graphql": {
"command": "npx",
"args": ["mcp-graphql", "--endpoint", "http://localhost:3000/graphql"]
}
}
}安全考虑
默认情况下,作为防止LLM修改数据库或服务数据的安全措施,会禁用突变。在生产环境中启用突变之前,请仔细考虑。
为您自己的服务器进行自定义
这是一个非常通用的实现,它允许用户进行完全的内省,并允许用户做任何事情(包括突变)。如果你需要一个更具体的实现,我建议你创建自己的MCP和锁定工具,让客户端只输入特定的查询字段和/或变量。您可以将此作为参考。
