AI招聘平台服务

MCP server for the revolutionAI hiring platform. Lets AI assistants search talent, scope projects, and manage the full hiring workflow — directly from Claude Code, Cursor, or any MCP-compatible client.

  • by cnida1989
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 cnida1989/revolutionai-mcp-server

使用说明

@revolutionai/mcp服务器

revolutionAI招聘平台的MCP服务器。让AI助手直接从Claude Code、Cursor或任何兼容MCP的客户端搜索人才、确定项目范围并管理完整的招聘工作流程。

快速开始

克劳德桌面/克劳德代码

添加到MCP配置(claude_desktop_config.json 或 .mcp.json):

{
  "mcpServers": {
    "revolutionai": {
      "command": "npx",
      "args": ["-y", "@revolutionai/mcp-server"],
      "env": {
        "REVOLUTIONAI_API_KEY": "rai_your_key_here"
      }
    }
  }
}

获取API密钥: 革命性的io/settings.

自托管(HTTP/SSE)

npm install
npm run build
npm run start:http
# Server listens on PORT 3001 (configurable via PORT env var)

客户端连接到 GET /sse 随着 Authorization: Bearer rai_xxx.

工具(12)

发现

工具 描述 范围
search_talent 按技能、预算、可用性、时区、评级搜索开发人员 阅读
get_talent_profile 获取开发人员的完整个人资料,包括费率、历史记录和链接 阅读
list_skills 浏览8个类别中的300+技能 阅读

项目

工具 描述 范围
scope_project 人工智能辅助范围界定——用自然语言描述,获取预算/时间表/技能/里程碑 阅读
create_project 创建招聘项目(从草稿开始) 编写
update_project 更新项目详细信息或发布/取消 写入
list_projects 使用可选状态筛选器列出您的项目 阅读

参与

工具 描述 范围
get_matches AI排名的开发者匹配在5个维度上得分 阅读
hire_developer 雇佣一名开发人员——创建合同、里程碑和Stripe结账 写
complete_engagement 批准里程碑(释放付款)、请求修改或争议 撰写

账户

工具 描述 范围
get_dashboard 账户概述:项目、合同、待批准、支出 阅读
search_docs 搜索平台文档 阅读

运输

运输 入口点 用例
标准 src/index.ts → dist/index.js 克劳德桌面,克劳德代码, npx
HTTP/SSE src/http.ts → dist/http.js 集中式服务器,Claude.ai MCP连接器

类型化客户端库

import { RevolutionAIClient } from "@revolutionai/mcp-server/client";

const client = await RevolutionAIClient.createInProcess(auth);

const results = await client.searchTalent({
  skills: ["TypeScript", "Next.js"],
  availability: "available",
  min_rating: 4.5,
});

const scope = await client.scopeProject({
  description: "Build a real-time dashboard with Stripe billing",
});

认证

API密钥使用 rai_ 前缀和支持两个作用域:

  • 读 --搜索人才、查看个人资料、范围项目、浏览技能、查看仪表板、搜索文档
  • 写 --阅读所有内容,再加上创建/更新项目、雇佣开发人员、管理里程碑、发布付款

密钥在数据库中经过bcrypt散列处理。服务器还验证相关的Clerk用户在每个请求中是否处于活动状态。

项目结构

src/
├── index.ts              # stdio transport entry point
├── http.ts               # HTTP/SSE transport entry point
├── server.ts             # MCP server factory (registers all 12 tools)
├── client.ts             # Typed client library
├── auth/
│   ├── api-key.ts        # API key validation + Clerk user verification
│   └── middleware.ts      # Scope and ownership checks
├── tools/
│   ├── index.ts          # Re-exports all tool groups
│   ├── discovery.ts      # search_talent, get_talent_profile, list_skills
│   ├── projects.ts       # scope_project, create_project, update_project, list_projects
│   ├── engagement.ts     # get_matches, hire_developer, complete_engagement
│   └── account.ts        # get_dashboard, search_docs
├── db/
│   ├── client.ts         # Supabase admin client factory
│   └── queries/
│       ├── talent.ts     # Talent search and profile queries
│       ├── projects.ts   # Project CRUD
│       ├── proposals.ts  # Proposal creation and status
│       └── contracts.ts  # Contracts and milestones
├── services/
│   ├── matching-engine.ts # Multi-dimensional talent scoring
│   └── payment-service.ts # Stripe checkout and milestone transfers
├── data/
│   ├── skills.ts         # Skill taxonomy (300+ skills, 8 categories)
│   └── docs.ts           # Platform documentation search index
├── types/
│   └── index.ts          # All TypeScript interfaces
└── utils/
    ├── errors.ts         # ToolError class, formatToolResponse/formatToolError
    ├── logger.ts         # Structured JSON logger (writes to stderr)
    └── pagination.ts     # Cursor-based pagination utilities

环境变量

# Required
REVOLUTIONAI_API_KEY=rai_xxx     # For stdio transport (client-side)
SUPABASE_URL=https://xxx.supabase.co
SUPABASE_SECRET_KEY=sb_secret_xxx

# Optional
STRIPE_SECRET_KEY=sk_xxx         # Required for payment operations
CLERK_SECRET_KEY=sk_xxx          # Required for user verification
PORT=3001                        # HTTP/SSE transport port

看 .env.example 对于完整模板。

脚本

npm run build       # Compile TypeScript
npm run dev         # Watch mode
npm run start       # stdio transport (requires .env)
npm run start:http  # HTTP/SSE transport (requires .env)
npm run test        # Run tool tests
npm run inspect     # Open MCP Inspector

许可证

麻省理工学院