Graip MCP

Graip MCP服务器

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

______________________________________________________________________

特性

支持的文件格式： 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 

两者 Bearer 和生 `` 格式被接受。

可选标头

______________________________________________________________________

MCP端点

服务器使用 流式HTTP 运输：

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

______________________________________________________________________

从AI客户端连接

克劳德桌面版

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

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

VS代码（GitHub副本）

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

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

光标

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

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

______________________________________________________________________

使用示例

一旦连接，您就可以通过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键都有自己的一组命名流。
• 配置在服务器重新启动时仍然有效。
• 不需要数据库。

______________________________________________________________________

环境变量

______________________________________________________________________

项目结构

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

______________________________________________________________________

脚本

______________________________________________________________________

许可证

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