AI导哈

文档处理API服务

Graip MCP Server是一个将Graip.AI文档处理API作为MCP工具暴露的服务，允许MCP兼容的AI客户端上传文档、提取结构化数据和管理处理流程。

  • by GRAIP-AS
  • TypeScript
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 GRAIP-AS/graip-mcp

使用说明

Graip MCP服务器

一 MCP（模型上下文协议） 暴露的服务器 明白了人工智能 文件处理API作为MCP工具。这允许任何兼容MCP的AI客户端（Claude Desktop、VS Code Copilot、Cursor等）上传文档、提取结构化数据，并通过自然语言管理处理流。

特性

工具 说明
添加流量 注册映射到Graip流ID的命名流（例如“发票”）
消除流动 删除以前注册的流
列表流 列出为当前用户配置的所有流
摘录文件 上传文档，对其进行处理，并返回提取的数据

支持的文件格式： PDF、PNG、JPEG、TIFF、ZIP （最大50 MB，每个PDF/TIFF最多10页）。

先决条件

  • Node.js ≥ 18
  • A. 明白了AI API 密钥 --获取一个 Flow → 设置→ 整合→ 新访问令牌 在Graip。AI应用程序。

快速开始

1.安装依赖项

npm install

2.建造

npm run build

3.跑步

npm start

服务器启动于 端口7891 默认情况下。用覆盖 MCP_PORT 环境变量：

MCP_PORT=8080 npm start

4.开发（手表模式）

npm run dev        # rebuilds on file changes
node dist/index.js # run in a separate terminal

认证

每个请求都必须包括您的Graip。AI API在 Authorization 头球

Authorization: Bearer <YOUR_GRAIP_API_KEY>

两者 Bearer <key> 和生 <key> 格式被接受。

可选标头

标题 描述
X-Graip-Flow-Id 当两者都没有时使用默认流ID flow 也不 flowId 提供给 extract-document

MCP端点

服务器使用 流式HTTP 运输：

方法 路径 目的
POST /mcp 发送JSON-RPC请求（工具调用、初始化）
GET /mcp 为服务器发送的事件打开SSE流
DELETE /mcp 终止会话

会话由 mcp-session-id 初始化后返回标头。

从AI客户端连接

克劳德桌面版

添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上）：

{
  "mcpServers": {
    "graip": {
      "url": "http://localhost:7891/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_GRAIP_API_KEY>"
      }
    }
  }
}

VS代码（GitHub副本）

添加到您的VS代码设置(.vscode/mcp.json):

{
  "servers": {
    "graip": {
      "type": "http",
      "url": "http://localhost:7891/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_GRAIP_API_KEY>"
      }
    }
  }
}

光标

添加到光标MCP配置(~/.cursor/mcp.json):

{
  "mcpServers": {
    "graip": {
      "url": "http://localhost:7891/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_GRAIP_API_KEY>"
      }
    }
  }
}

使用示例

一旦连接，您就可以通过AI客户端中的自然语言与工具进行交互。

注册流

“添加一个名为 发票 带ID xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx."

在Graip中选择流时，流ID位于URL的末尾。AI应用程序。

列表流

“显示我配置的流。”

从文档中提取数据

“使用 发票 流动。"

或者提供原始流ID：

“使用流ID处理此PDF xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx."

该工具接受base64编码的文件，并将完整提取的数据作为结构化JSON返回。

删除流

“删除 发票 流动。"

每用户配置

流配置存储在本地 ~/.graip-mcp/users/ 并且通过API密钥的散列来进行密钥。这意味着：

  • 每个API键都有自己的一组命名流。
  • 配置在服务器重新启动时仍然有效。
  • 不需要数据库。

环境变量

变量 默认值 描述
MCP_PORT 7891 HTTP服务器侦听的端口

项目结构

graip-mcp/
├── src/
│   └── index.ts          # MCP server, tools, and Express app
├── openapi.yaml           # Graip.AI REST API OpenAPI spec
├── logo.svg               # Server icon
├── package.json
└── tsconfig.json

脚本

命令 描述
npm run build 将TypeScript编译为 dist/
npm run dev 在监视模式下编译
npm start 运行已编译的服务器
npm run typecheck 不发射的类型检查

许可证

麻省理工学院-- 明白了人工智能

相关 MCP