MCP Freelancer Server

MCP自由职业者服务器🚀

用于自由职业者服务自动化的专业MCP（模型上下文协议）服务器。

🎯 特性

• LinkedIn个人资料优化 -基于人工智能的个人资料分析和建议
• 声调分析 -识别并保持一致的品牌声音
• 心理触发因素 -发现什么能引起观众的共鸣
• 内容策略 -获取个性化的内容创意和发布计划
• 竞争对手洞察 -从你所在领域的成功案例中学习
• 可扩展架构 -易于添加新服务（推特、简历、投资组合等）

🛠️ 技术栈

• Node.js 20+ -运行时环境
• TypeScript -类型安全开发
• 快速 -Web服务器框架
• API克劳德 -人工智能分析（Anthropic）
• 谷歌表格 -可选数据库集成

📦 快速开始

1.克隆或下载

# If using git
git clone https://github.com/your-username/mcp-freelancer-server.git
cd mcp-freelancer-server

# Or download ZIP and extract

2.安装依赖项

npm install

3.配置环境

复制 .env.example 到 .env 并填写您的值：

cp .env.example .env

所需变量：

NODE_ENV=production
PORT=10000
CLAUDE_API_KEY=sk-ant-api03-your-key-here

4.构建和运行

# Build TypeScript
npm run build

# Start server
npm start

# Or for development with auto-reload
npm run dev

5.测试

访问： http://localhost:10000/health

您应该看到：

{
  "status": "ok",
  "timestamp": "...",
  "uptime": 123
}

🚀 部署到Render.com（免费！）

第一步：推送到GitHub

1. 创建新的GitHub存储库
2. 推送你的代码：

git init
git add .
git commit -m "Initial commit"
git branch -M main
git remote add origin https://github.com/your-username/mcp-freelancer-server.git
git push -u origin main

步骤2：在渲染上部署

1. 首选 render.com
2. 在GitHub上注册
3. 点击“新建+”→ “Web服务”
4. 选择您的GitHub仓库
5. 配置：

- 名字：mcp自由职业者 - 环境：节点 - 生成命令: npm install && npm run build - 启动命令: npm start - 计划：免费

1. 添加环境变量：

- NODE_ENV=production - PORT=10000 - CLAUDE_API_KEY=sk-ant-...

1. 点击“创建Web服务”

您的服务器将运行在： https://mcp-freelancer.onrender.com

📡 API终点

健康检查

GET /health

答复：

{
  "status": "ok",
  "timestamp": "2024-01-15T10:30:00.000Z",
  "uptime": 3600,
  "version": "1.0.0"
}

主要分析

POST /api/analyze
Content-Type: application/json

{
  "client_id": "123",
  "service": "linkedin_optimization",
  "data": {
    "name": "Ahmed",
    "email": "ahmed@example.com",
    "linkedin_url": "linkedin.com/in/ahmed",
    "goals": "Build authority, Get consulting clients",
    "pain_points": "Low engagement, No clear positioning"
  }
}

答复：

{
  "success": true,
  "report": {
    "client_info": { ... },
    "analysis": {
      "voice_tone": "...",
      "psychological_triggers": "...",
      "content_strategy": "...",
      "profile_optimization": "...",
      "competitor_insights": "..."
    },
    "metadata": {
      "timestamp": "...",
      "processing_time_ms": 2500,
      "model_used": "claude-3-5-haiku-20241022"
    }
  }
}

测试克劳德连接

POST /api/test
Content-Type: application/json

{
  "prompt": "Say hello!"
}

🔧 包含MCP工具

1. 语音分析仪 -分析写作风格和品牌声音
2. 心理触发检测器 -识别说服技巧
3. 内容创意生成器 -创建个性化内容策略
4. 配置文件优化器 -LinkedIn个人资料推荐
5. 竞争对手分析器 -来自成功案例的见解

💰 成本估算

Render.com（主机）

• 免费层：0美元/月
• 750小时/月（足够全天候正常运行）
• 15分钟不活动后睡眠（30-60秒冷启动）

API（人工智能处理）

• 模型：claude-3-5-haiku-20241022
• 成本：每次分析约0.05美元
• 预期：50-100名客户每月3-5美元

总计：3-5美元/月 🎉

🔐 安全最佳实践

• ✅ 永不承诺 .env 文件
• ✅ 使用环境变量作为机密
• ✅ 添加生产身份验证（可选）
• ✅ 仅对受信任的域启用CORS
• ✅ 速率限制API端点（如果需要）

📊 监控和日志

在渲染仪表板中查看日志：

1. 为您服务
2. 点击“日志”选项卡
3. 监控实时请求和错误

🐛 故障排除

服务器无法启动

• 检查 CLAUDE_API_KEY 设置正确
• 验证Node.js版本>=20.0.0
• 跑 npm install 再次

分析返回错误

• 验证Claude API密钥是否有效
• 检查API配额/限制
• 查看渲染日志以了解详细信息

冷启动缓慢

• 正常用于无渲染层（30-60s）
• 服务器在请求后保持唤醒状态15分钟
• 考虑付费计划以获得即时响应

📚 扩展服务器

添加新服务

1. 在中创建新的工具功能 src/index.ts:

async function analyzeTwitterProfile(data: any): Promise {
  const prompt = `Analyze Twitter profile for: ${data.twitter_url}`;
  // ... Claude API call
  return response;
}

1. 增添 /api/analyze 端点：

if (service === 'twitter_branding') {
  const twitterAnalysis = await analyzeTwitterProfile(data);
  // ... include in report
}

1. 部署-从GitHub渲染自动部署！

📞 支持

• 查看设置指南： setup_guide.md
• 审查实施计划： implementation_plan.md
• GitHub问题：为bug/功能创建问题

📄 许可证

麻省理工学院许可证-自由使用您的自由职业者业务！

🎉 鸣谢

内置：

• 安thropic克劳德 -AI分析
• Render.com -免费主机
• 快速 -Web框架
• TypeScript -类型安全

______________________________________________________________________

准备好自动化你的自由职业者服务了吗？立即部署！ 🚀