MCP Agent Server

🚀 MCP Agent Server

MCP Agent Server 是一個開源的 AI 員工“大腦”，旨在與 n8n 等工作流引擎無縫協作，為 AI 員工/代理提供強大的支持。

🚀 快速開始

1. 克隆倉庫：

   git clone https://github.com/yourusername/mcp-agent-server.git
   cd mcp-agent-server
   

2. 如有需要，複製文檔和內存文件夾。
3. 使用 Docker Compose 構建並運行：

   docker-compose up --build
   

4. MCP 服務器將在 http://localhost:4000 上可用。

🎉 開始使用

1. 確保你已安裝 Node.js 和 Docker。
2. 移除 package.json 中的所有註釋（JSON 不支持註釋）。
3. 運行 npm install 安裝依賴項。
4. 使用 docker-compose up --build 啟動所有服務。
5. 服務器將在 http://localhost:4000 上可用。
6. 有關架構和設計，請查看 /docs 和 /memory 文件夾以及 MCP 內存中的“mcp-agent-server 項目計劃”。

📁 項目結構

• /docs — 設計、架構和使用文檔
• /memory — 持久內存、日誌和知識

🎯 項目願景：MCP Agent Server

mcp-agent-server 是一個開源的、模塊化的 AI 員工/代理“大腦”，旨在與 n8n 和其他工作流引擎無縫協作。

• AI 員工隱喻： 允許用戶“僱傭”、“分配任務”、“評估”和“改進”持久化的 AI 代理，每個代理都有自己的記憶、學習和反饋循環。
• 有主見且以代理為中心： 與通用的工作流自動化工具不同，MCP 代理服務器有自己的主見，專注於“AI 員工”隱喻，使記憶、反饋和學習成為核心功能，而非可選附加功能。
• 自然語言接口： 接受自然語言指令（不僅僅是 API 調用或工作流觸發器），將其解析為可執行任務，並通過 n8n 或其他連接器編排執行。
• 主動、自適應和個性化： 代理可以建議操作，從用戶反饋中學習，並隨著時間的推移不斷改進。
• 垂直解決方案與簡單性： 支持具有預建技能、工作流和反饋循環的垂直解決方案（例如“AI 分析師”、“AI 管理員”），併為中小企業和個人提供簡單、非技術性的用戶體驗。
• 持久的、以代理為中心的記憶： 記憶和反饋是持久的且以代理為中心，使代理能夠記住過去的操作、用戶偏好和性能歷史。
• 易於部署和擴展： 設計用於易於部署（Docker、Docker Compose）、擴展（可插拔的連接器和技能）和 SaaS 貨幣化（多租戶、API 密鑰管理、計費集成）。
• 不僅僅是另一個工作流工具： MCP 代理服務器是一個用於構建、管理和改進與人類協同工作、從經驗中學習並提供實際商業價值的 AI 員工的平臺。

🔑 API 認證

除 /health、/users/register 和 /users/login 外，所有端點都需要 x-api-key 頭部。API 密鑰按用戶管理。有關用戶和 API 密鑰管理，請參閱以下內容。

👤 用戶與 API 密鑰管理

端點

• POST /users/register — 註冊新用戶（郵箱、密碼）
• POST /users/login — 登錄並獲取 API 密鑰
• GET /users/me/api-keys — 列出你的 API 密鑰
• POST /users/me/api-keys — 創建新的 API 密鑰
• DELETE /users/me/api-keys/:id — 撤銷 API 密鑰

PowerShell 使用示例

# 註冊新用戶
Invoke-RestMethod -Uri "http://localhost:4000/users/register" -Method Post -ContentType "application/json" -Body '{"email": "user@example.com", "password": "yourpassword"}'

# 登錄並獲取 API 密鑰
$login = Invoke-RestMethod -Uri "http://localhost:4000/users/login" -Method Post -ContentType "application/json" -Body '{"email": "user@example.com", "password": "yourpassword"}'
$apiKey = $login.apiKey

# 列出 API 密鑰
Invoke-RestMethod -Uri "http://localhost:4000/users/me/api-keys" -Method Get -Headers @{ "x-api-key" = $apiKey }

# 創建新的 API 密鑰
Invoke-RestMethod -Uri "http://localhost:4000/users/me/api-keys" -Method Post -Headers @{ "x-api-key" = $apiKey }

# 撤銷 API 密鑰（將 1 替換為實際的密鑰 ID）
Invoke-RestMethod -Uri "http://localhost:4000/users/me/api-keys/1" -Method Delete -Headers @{ "x-api-key" = $apiKey }

curl 使用示例

# 註冊新用戶
curl -X POST http://localhost:4000/users/register -H "Content-Type: application/json" -d '{"email": "user@example.com", "password": "yourpassword"}'

# 登錄並獲取 API 密鑰
curl -X POST http://localhost:4000/users/login -H "Content-Type: application/json" -d '{"email": "user@example.com", "password": "yourpassword"}'

# 列出 API 密鑰
curl http://localhost:4000/users/me/api-keys -H "x-api-key: <your-api-key>"

# 創建新的 API 密鑰
curl -X POST http://localhost:4000/users/me/api-keys -H "x-api-key: <your-api-key>"

# 撤銷 API 密鑰（將 1 替換為實際的密鑰 ID）
curl -X DELETE http://localhost:4000/users/me/api-keys/1 -H "x-api-key: <your-api-key>"

🧠 代理記憶與反饋端點

• POST /agents/:id/memory — 為代理添加記憶/反饋。
• GET /agents/:id/memory — 列出代理的所有記憶/反饋。
• POST /agents/:id/trigger — 觸發代理操作（n8n 集成的存根）。

PowerShell 使用示例

$headers = @{ "x-api-key" = "changeme" }

# 創建代理
Invoke-RestMethod -Uri "http://localhost:4000/agents" -Method Post -Headers $headers -ContentType "application/json" -Body '{"name": "Test Agent"}'

# 添加記憶/反饋
Invoke-RestMethod -Uri "http://localhost:4000/agents/1/memory" -Method Post -Headers $headers -ContentType "application/json" -Body '{"content": "Agent completed onboarding."}'

# 列出記憶/反饋
Invoke-RestMethod -Uri "http://localhost:4000/agents/1/memory" -Method Get -Headers $headers

# 觸發代理
Invoke-RestMethod -Uri "http://localhost:4000/agents/1/trigger" -Method Post -Headers $headers

curl 使用示例

curl -X POST http://localhost:4000/agents/1/memory -H "Content-Type: application/json" -H "x-api-key: changeme" -d '{"content": "Agent completed onboarding."}'
curl http://localhost:4000/agents/1/memory -H "x-api-key: changeme"
curl -X POST http://localhost:4000/agents/1/trigger -H "x-api-key: changeme"

🗄️ 數據庫遷移與模式管理

• 所有數據庫遷移在容器啟動時自動應用（請參閱 docker-entrypoint.sh）。
• 要添加新模型或字段：
  1. 編輯 prisma/schema.prisma。
  2. 在本地運行 npx prisma migrate dev --name <desc>（運行你的 Docker Postgres）。
  3. 將生成的遷移文件提交到 prisma/migrations/ 中的 git。
• 在每次部署或容器重建時，所有遷移將自動應用。