mcp-graphql-forge

基本能力

产品定位

mcp-graphql-forge 是一个轻量级、配置驱动的 MCP 服务器，旨在通过 YAML 配置文件将 GraphQL 查询公开为模块化工具，从而简化 API 交互。

核心功能

1. 配置驱动：通过 YAML 文件定义 GraphQL 查询及其参数，无需修改应用程序代码。
2. 模块化工具：每个 YAML 文件定义一个工具，工具可以轻松扩展。
3. 安全性：所有请求使用相同的 Bearer token 进行授权。
4. 轻量级：专注于最小化实现，减少不必要的复杂性。

适用场景

1. 开发效率工具：为开发人员提供快速访问 GraphQL 查询的能力。
2. API 交互：代理可以通过工具进行有意的 API 交互。
3. 模块化扩展：需要快速扩展功能而不修改代码的场景。

工具列表

1. getUser：通过 login 获取用户的基本信息，包括名称、URL 和位置。
2. 输入：login（字符串，必需）。
3. 查询：执行 GraphQL 查询以获取用户信息。

常见问题解答

1. 局限性：
2. 每个实例只能与单个 GraphQL 服务器的一个 URL 一起使用。
3. 所有请求使用相同的 Authorization header（Bearer token）。
4. GraphQL 查询仅作为工具公开，即使它们不是突变。

使用教程

使用依赖

1. 确保已安装 Node.js 和 npm。
2. 确保已配置 GraphQL 端点。

安装教程

1. 克隆或下载 mcp-graphql-forge 仓库。
2. 安装依赖： bash npm install
3. 配置环境变量 FORGE_CONFIG 指向包含 YAML 配置文件的文件夹。

调试方式

1. 启动服务器： bash npm start
2. 使用工具进行测试，例如调用 getUser 工具： bash curl -X POST http://localhost:3000/tools/getUser -H "Content-Type: application/json" -d '{"login":"username"}'

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。