Poe模型协议工具

Poe-MCP是一个模型上下文协议服务器和CLI工具,用于查询Poe机器人和搜索模型目录,支持服务器模式和命令行工具两种使用方式。

  • by n0madic
  • Go
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 n0madic/poe-mcp

使用说明

Poe MCP

MCP(模型上下文协议)服务器和CLI工具 坡 机器人和模型目录。将其用作:

  • MCP服务器:与MCP兼容的客户端(Claude Code、Cursor等)集成,以查询机器人和搜索模型
  • CLI工具:直接从终端运行,进行快速机器人查询和模型搜索

用法

MCP服务器模式

跑 poe-mcp 无需参数即可启动MCP服务器:

POE_API_KEY=<key> poe-mcp

然后配置MCP客户端(请参阅 配置 在......下面

MCP工具

query_bot

向任何Poe机器人发送消息并获得完整回复。支持文件附件。

参数 类型 必填 说明
bot string yes Poe上的机器人名称(例如GPT-4o、Claude-4.5-Sonnet)
message string yes 要发送给机器人的用户消息
files array no 要附加的文件(本地路径或URL)
temperature 浮子 否 取样温度(0.0–2.0)

这 files 参数接受一个字符串数组——每个字符串要么是本地文件路径,要么是URL(由自动检测) http:///https:// 前缀)。文件名会自动提取。

例子: "files": ["/path/to/local.pdf", "https://example.com/image.jpg"]

search_models

搜索并筛选Poe模型目录。

参数 类型 必填 说明
query string no ID、名称、描述、所有者上不区分大小写的子字符串匹配
owned_by string no 按所有者/提供者筛选(例如OpenAI、Anthropic)
modality string no 按模态子字符串(如文本、图像)过滤

命令行接口命令模式

跑 poe-mcp 具有用于直接终端访问的子命令:

搜索模型 (不需要API密钥):

# Search all models
poe-mcp search "GPT-4o"

# Filter by owner
poe-mcp search --owner OpenAI

# Filter by modality
poe-mcp search --modality image

# Combine filters and query
poe-mcp search --owner Google --modality text "pro"

查询机器人 (要求 POE_API_KEY):

export POE_API_KEY=<key>
# Basic query
poe-mcp query GPT-4o "What is Go?"

# With temperature setting
poe-mcp query -t 0.7 Claude-4.5-Sonnet "Explain monads"
poe-mcp query --temperature 0.9 GPT-5.2-Pro "Write a poem"

# Attach files (local paths or URLs, auto-detected)
poe-mcp query -f photo.jpg GPT-4o "Describe this image"
poe-mcp query -f doc.pdf -f chart.png GPT-4o "Summarize these files"
poe-mcp query -f https://example.com/image.jpg GPT-4o "What's in this image?"
poe-mcp query -f local.pdf -f https://example.com/remote.pdf GPT-4o "Compare these"

查询标志:

  • -t, --temperature <float> --采样温度(0.0-2.0,默认值:0.7)
  • -f, --file <path|url> --附加文件:本地路径或URL(可重复)

安装

go install github.com/n0madic/poe-mcp@latest

或者从源代码构建:

git clone https://github.com/n0madic/poe-mcp.git
cd poe-mcp
go build .

配置

克劳德代码

添加到您的Claude Code MCP设置中(~/.claude/claude_desktop_config.json 或项目 .mcp.json):

{
  "mcpServers": {
    "poe": {
      "command": "poe-mcp",
      "env": {
        "POE_API_KEY": "your-poe-api-key"
      }
    }
  }
}

游标/其他MCP客户端

使用以下配置MCP服务器:

  • 命令: poe-mcp
  • 环境: POE_API_KEY=your-poe-api-key
  • 运输: 标准

环境变量

变量 必填 描述
POE_API_KEY 对于MCP服务器模式和 query 用于机器人程序查询的CLI命令 Poe API密钥。不需要 search CLI命令。

获取Poe API密钥

  1. 首选 poe.com
  2. 生成或复制API密钥

许可证

麻省理工学院