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规范