@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许可证
麻省理工学院