Graphor远程MCP服务器

Graphor远程MCP服务器允许AI助手和代理框架通过Model Context Protocol (MCP)连接到Graphor API,运行于Cloudflare Workers并使用OAuth进行认证。

  • by synapseops
  • TypeScript
  • 混合部署
  • 更新于
在 GitHub 查看 synapseops/graphor-mcp-server

使用说明

Graphor远程MCP服务器

Graphor Remote MCP Server允许您将AI助手和代理框架连接到 图示器 API使用 模型上下文协议(MCP)。它在Cloudflare Workers上运行,并使用 OAuth 用于身份验证。

服务器URL:

https://mcp.graphor.workers.dev/sse

正在寻找本地MCP服务器吗?看 本地MCP服务器 以下部分或 graphor mcp 包裹。

本地MCP服务器

对于本地MCP客户端(例如Cursor、VS Code),您可以使用 graphor-mcp 通过API密钥而不是OAuth进行身份验证的包。

使用以下按钮直接安装:

或者手动将其添加到MCP客户端的配置中:

{
  "mcpServers": {
    "graphor_api": {
      "command": "npx",
      "args": ["-y", "graphor-mcp@latest"],
      "env": {
        "GRAPHOR_API_KEY": "grlm_your_api_key_here"
      }
    }
  }
}

注意:您可以从获取API密钥 graphorlm.com.

远程MCP服务器

对于无法在本地运行的基于web的AI客户端(如Claude.AI)或代理框架(如LangChain、CrewAI) npx 进程,使用托管的远程MCP服务器。身份验证通过以下方式处理 OAuth --浏览器窗口将打开供您登录。

Claude.ai

  1. 首选 设置>连接器>添加自定义连接器
  2. 填写 名字 (例如“Graphor”)
  3. 设置 远程MCP服务器URL 致:
https://mcp.graphor.workers.dev/sse
  1. 您将被重定向到通过OAuth流登录
  2. 一旦通过身份验证,Graphor工具将在您的对话中可用

克劳德桌面

将以下内容添加到您的Claude Desktop配置文件中(设置>开发人员>编辑配置):

{
  "mcpServers": {
    "graphor_api": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.graphor.workers.dev/sse"]
    }
  }
}

当您打开Claude Desktop时,将打开一个浏览器窗口供您登录。身份验证后,Graphor工具将出现在对话的右下角。

光标

将以下内容添加到光标MCP配置中(设置>工具和MCP>新MCP服务器):

{
  "mcpServers": {
    "graphor_api": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.graphor.workers.dev/sse"]
    }
  }
}

代理工作流(LangChain、CrewAI等)

对于支持MCP的代理框架,请通过SSE传输连接到远程服务器:

语言链(Python):

from langchain_mcp_adapters.client import MultiServerMCPClient

async with MultiServerMCPClient(
    {
        "graphor": {
            "url": "https://mcp.graphor.workers.dev/sse",
            "transport": "sse",
        }
    }
) as client:
    tools = client.get_tools()
    # Use tools with your LangChain agent

语言链(TypeScript):

import { MultiServerMCPClient } from "@langchain/mcp-adapters";

const client = new MultiServerMCPClient({
  graphor: {
    url: "https://mcp.graphor.workers.dev/sse",
    transport: "sse",
  }
});

const tools = await client.getTools();
// Use tools with your LangChain agent

注意:OAuth流将在第一次连接时打开浏览器窗口。对于无头环境,您可能需要提前完成OAuth流程或使用 mcp-remote 作为本地代理。

任何兼容MCP的客户端

对于通过SSE支持远程MCP服务器的任何客户端,请使用以下URL:

https://mcp.graphor.workers.dev/sse

仅支持的客户 stdio 运输、使用 mcp-remote 作为一座桥梁:

{
  "mcpServers": {
    "graphor_api": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.graphor.workers.dev/sse"]
    }
  }
}

故障排除

如果您在连接时遇到问题,请尝试以下操作:

  1. 重新启动客户端 (克劳德桌面、光标等)

  2. 直接测试连接 在命令行上:

npx mcp-remote https://mcp.graphor.workers.dev/sse
  1. 清除OAuth缓存 如果身份验证似乎卡住:
rm -rf ~/.mcp-auth

自足执行

您可以将此服务器的自己的实例部署到Cloudflare Workers。

一键部署

手动部署

  1. 克隆此存储库并安装依赖项:
npm install
  1. 创建KV命名空间:
npx wrangler@latest kv namespace create remote-mcp-server-oauth-kv
  1. 将KV命名空间ID添加到 wrangler.jsonc

  2. 部署:

npm run deploy

本地开发

npm install
npm run dev

服务器将在以下时间可用 http://localhost:8787/.

用测试 MCP检查员:

  1. 跑 npx @modelcontextprotocol/inspector
  2. 将传输类型切换为 SSE 并进入 http://localhost:8787/sse
  3. 点击“连接”并通过OAuth屏幕登录