MCP Pickaxe

🚀 MCP Pickaxe Server

MCP（模型上下文協議）服務器，可將Claude等AI助手連接到Pickaxe平臺。你可以直接通過自然語言管理AI代理、知識庫、用戶和分析數據。

🚀 快速開始

MCP Pickaxe Server是一個強大的工具，它能幫助你在Pickaxe平臺上更高效地管理AI相關事務。通過將AI助手（如Claude）與Pickaxe平臺連接，你可以利用自然語言進行各種操作。

✨ 主要特性

如果你正在Pickaxe上構建AI代理，此MCP服務器允許你：

• 分析代理對話 - 查看聊天曆史，識別知識差距，提高代理性能。
• 管理知識庫 - 在不離開AI工作流程的情況下創建、更新文檔並將其連接到代理。
• 處理用戶管理 - 創建用戶、管理訪問權限、發送邀請並跟蹤使用情況。
• 跨多個工作室工作 - 在單個會話中無縫切換不同的Pickaxe工作室。
• 自動化工作流程 - 讓Claude處理重複性的Pickaxe管理任務。

📦 安裝指南

前提條件

• Node.js 18+
• 擁有具有API訪問權限的Pickaxe賬戶
• 你的Pickaxe Studio API密鑰

安裝方式

選項1：從npm安裝（推薦）

npx mcp-pickaxe

或者全局安裝：

npm install -g mcp-pickaxe

選項2：克隆並構建

git clone https://github.com/aplaceforallmystuff/mcp-pickaxe.git
cd mcp-pickaxe
npm install
npm run build

💻 使用示例

基礎用法

配置完成後，你可以通過自然語言與Pickaxe進行交互：

# 分析代理性能
> "Show me the last 20 conversations from my support agent"
> "What questions are users asking that my agent can't answer?"

# 管理知識庫
> "Create a new document called 'FAQ' with this content: [your content]"
> "Connect the FAQ document to my customer support agent"
> "List all documents in my knowledge base"

# 用戶管理
> "Show me all users and their usage stats"
> "Create a new user with email user@example.com and give them access to the Pro product"
> "Send invitations to these emails: [list of emails]"

# 多工作室操作
> "List all users in my staging studio"
> "Compare the documents between production and staging"

高級用法

你還可以使用提供的工具進行更細緻的操作，以下是一些工具的使用示例：

# 工作室管理
studios_list

# 聊天曆史
chat_history --pickaxeId=123 --skip=0 --limit=10 --format=messages --studio=staging

# 文檔管理
doc_create --content="This is a new document"
doc_list --page=1 --limit=10
doc_get --docId=456
doc_delete --docId=456
doc_connect --docId=456 --agentId=789
doc_disconnect --docId=456 --agentId=789

# 用戶管理
user_list
user_get --email=user@example.com
user_create --email=user2@example.com --product=Pro
user_update --email=user2@example.com --product=Enterprise
user_delete --email=user2@example.com
user_invite --emails=user3@example.com,user4@example.com

# 產品
products_list

# 記憶
memory_list
memory_get_user --userId=101

📚 詳細文檔

配置

1. 獲取Pickaxe API密鑰

1. 登錄Pickaxe Studio。
2. 導航到設置 > API。
3. 複製你的Studio API密鑰（以studio-開頭）。

2. 配置MCP客戶端

對於Claude Desktop

添加到Claude Desktop配置文件：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "pickaxe": {
      "command": "node",
      "args": ["/path/to/mcp-pickaxe/dist/index.js"],
      "env": {
        "PICKAXE_STUDIO_MAIN": "studio-your-api-key-here"
      }
    }
  }
}

對於Claude Code

添加到~/.claude.json：

{
  "mcpServers": {
    "pickaxe": {
      "command": "node",
      "args": ["/path/to/mcp-pickaxe/dist/index.js"],
      "env": {
        "PICKAXE_STUDIO_MAIN": "studio-your-api-key-here"
      }
    }
  }
}

多工作室配置

要使用多個Pickaxe工作室，添加多個環境變量：

{
  "env": {
    "PICKAXE_STUDIO_PRODUCTION": "studio-xxx-xxx-xxx",
    "PICKAXE_STUDIO_STAGING": "studio-yyy-yyy-yyy",
    "PICKAXE_STUDIO_DEV": "studio-zzz-zzz-zzz",
    "PICKAXE_DEFAULT_STUDIO": "PRODUCTION"
  }
}

然後在請求中指定要使用的工作室：

• 如果你設置了PICKAXE_DEFAULT_STUDIO，在未指定工作室時將使用該工作室。
• 如果僅配置了一個工作室，將自動使用該工作室。
• 否則，在任何工具中傳遞studio="STAGING"（或類似參數）。

可用工具

工作室管理

• studios_list - 列出所有已配置的工作室和當前默認工作室

聊天曆史

• chat_history - 獲取代理的對話歷史
  • 參數：pickaxeId、skip、limit、format（"messages" 或 "raw"）、studio

文檔管理

• doc_create - 從內容或URL創建文檔
• doc_list - 列出所有文檔（支持分頁）
• doc_get - 獲取特定文檔
• doc_delete - 刪除文檔
• doc_connect - 將文檔鏈接到代理
• doc_disconnect - 取消文檔與代理的鏈接

用戶管理

• user_list - 列出所有具有訪問權限和使用信息的用戶
• user_get - 通過電子郵件獲取特定用戶
• user_create - 創建新用戶
• user_update - 更新用戶詳細信息、產品或使用情況
• user_delete - 刪除用戶
• user_invite - 發送電子郵件邀請

產品

• products_list - 列出可用的產品/套餐

記憶

• memory_list - 列出記憶模式
• memory_get_user - 獲取用戶收集的記憶

開發

# 在開發模式下運行（自動重新加載）
npm run dev

# 為生產環境構建
npm run build

# 運行構建後的版本
npm start

故障排除

"No Pickaxe studios configured"

確保在你的MCP配置中至少設置了一個PICKAXE_STUDIO_*環境變量。

"Studio not found"

檢查工作室名稱是否完全匹配（不區分大小寫）。運行studios_list查看可用選項。

"Pickaxe API error (401)"

你的API密鑰無效或已過期。從Pickaxe Studio設置中獲取新的密鑰。

"Pickaxe API error (403)"

你的API密鑰沒有執行此操作的權限。檢查你的Pickaxe賬戶權限。

📄 許可證

本項目採用MIT許可證，詳情請見LICENSE。

🔗 相關鏈接

• Pickaxe平臺
• Pickaxe工作室
• 模型上下文協議
• MCP規範