Agent.AI MCP Server

Agent.AI MCP 服务

这是 Agent.AI MCP 服务的可外部部署版本，旨在托管在 Vercel 上，并供其他应用程序调用。

部署说明

前提条件

• GitHub 账号
• Vercel 账号（免费套餐即可）
• 本地已安装 Git

部署步骤

1. 创建新的 GitHub 仓库

   git init
   git add .
   git commit -m "Initial commit: Agent.AI MCP Server"
   git branch -M main
   git remote add origin https://github.com/YOUR_USERNAME/agentai-mcp-server.git
   git push -u origin main
   

2. 部署到 Vercel

   • 访问 vercel.com
   • 点击“New Project”
   • 导入你的 GitHub 仓库
   • Vercel 会自动将其识别为 Node.js 项目
   • 点击“Deploy”

3. 获取部署 URL

   • 部署完成后，Vercel 会提供类似 https://your-project-name.vercel.app 的 URL
   • 这是你的 MCP 服务端点

用法

部署完成后，你可以使用 Vercel URL 从其他应用程序调用 MCP 服务。

用法示例

// In your other app
const mcpServerUrl = 'https://your-project-name.vercel.app';

// Make requests to your MCP server
fetch(mcpServerUrl + '/your-endpoint')
  .then(response => response.json())
  .then(data => console.log(data));

本地开发

如需在本地运行：

npm install
npm start

服务将在 http://localhost:3000 上启动

配置

• 端口：由 Vercel 自动设置；在本地运行时默认为 3000
• 环境变量：可在 Vercel 控制面板的 Project Settings > Environment Variables 中设置

故障排除

• 确保 @agentai/mcp-server 包已公开发布
• 如果出现问题，请检查 Vercel 部署日志
• 确认你的 GitHub 仓库为公开仓库，或 Vercel 已获得访问权限

重要：身份验证设置

1. 配置 Agent.AI API 令牌

你的 MCP 服务需要 Agent.AI API 令牌才能通过身份验证访问 Agent.AI 服务：

1. 从 Agent.AI 获取 API 令牌
2. 前往 Vercel 项目控制面板
3. 点击“Settings” → “Environment Variables”
4. 添加一个新变量：
   • 名称：API_TOKEN
   • 值：你的 Agent.AI API 令牌
5. 重新部署项目

2. 禁用 Vercel 身份验证

要允许外部访问你的 MCP 服务，你必须禁用 Vercel 内置的身份验证：

1. 前往 Vercel 项目控制面板
2. 点击“Settings” → “Security”
3. 禁用“Password Protection”和“Vercel Authentication”
4. 保存更改

3. 测试身份验证

设置完成后，你的端点将返回：

• ✅ "authentication": "configured" - 已配置，可使用
• ❌ "authentication": "missing" - 需要设置 API_TOKEN