使用说明
Polymarket Go MCP
一种基于Go-based的MCP(模型上下文协议)服务器,用于通过Gamma API和data API访问Polymarket预测市场数据。
特性
- 📊 市场数据 -获取实时市场价格、交易量和流动性
- 🔍 市场搜索 -按关键字和类别查找市场
- 📈 价格历史记录 -获取历史价格数据和趋势
- 💰 投资组合跟踪 -监视器位置和PnL
- 🚀 高性能 -使用Go构建,性能快速可靠
- 🔧 开发者友好 -Go开发人员的多种安装选项
快速开始
Go开发者推荐
选项1:从源代码安装(最新版本)
go install github.com/ivanzzeth/polymarket-go-mcp/cmd/polymarket-go-mcp@latest
选项2:从源代码构建
git clone https://github.com/ivanzzeth/polymarket-go-mcp
cd polymarket-go-mcp
go build -o polymarket-go-mcp ./cmd/polymarket-go-mcp
选项3:下载预构建二进制文件
# Linux AMD64
curl -L https://github.com/ivanzzeth/polymarket-go-mcp/releases/latest/download/polymarket-go-mcp-linux-amd64 -o polymarket-go-mcp
chmod +x polymarket-go-mcp
# macOS ARM64
curl -L https://github.com/ivanzzeth/polymarket-go-mcp/releases/latest/download/polymarket-go-mcp-darwin-arm64 -o polymarket-go-mcp
chmod +x polymarket-go-mcp
# Windows AMD64
curl -L https://github.com/ivanzzeth/polymarket-go-mcp/releases/latest/download/polymarket-go-mcp-win-amd64.exe -o polymarket-go-mcp.exe
为所有用户
选项4:使用npx(无需安装)
npx -y polymarket-go-mcp
选项5:使用Docker
docker run --rm -it ivanzzeth/polymarket-go-mcp:latest
配置
克劳德桌面
添加到您的 claude_desktop_config.json:
{
"mcpServers": {
"polymarket": {
"command": "polymarket-go-mcp"
}
}
}
适用于Go安装用户
如果您是通过安装的 go install,二进制文件将在您的 $GOPATH/bin 或 $GOBIN。请确保此目录位于您的PATH中:
{
"mcpServers": {
"polymarket": {
"command": "polymarket-go-mcp"
}
}
}
对于源代码构建用户
如果从源代码构建,请使用完整路径:
{
"mcpServers": {
"polymarket": {
"command": "/path/to/polymarket-go-mcp/polymarket-go-mcp"
}
}
}
可用工具
市场数据工具
get_market_data-获取详细的市场信息search_markets-按关键字搜索市场get_market_prices-获取当前市场价格get_market_history-获取历史价格数据
投资组合工具
get_positions-获取用户位置get_pnl-计算损益get_portfolio_value-获取投资组合总价值
分析工具
get_liquidity_data-获取市场流动性信息get_volume_data-获取交易量统计数据get_market_trends-分析市场趋势
发展
先决条件
- 转到1.24或更高版本
- Git
从源头构建
# Clone the repository
git clone https://github.com/ivanzzeth/polymarket-go-mcp
cd polymarket-go-mcp
# Install dependencies
go mod download
# Build the binary
go build -o polymarket-go-mcp ./cmd/polymarket-go-mcp
# Test the build
./polymarket-go-mcp --version
运行测试
# Run all tests
go test ./...
# Run tests with coverage
go test -cover ./...
# Run integration tests
go test -tags=integration ./...
项目结构
polymarket-go-mcp/
├── cmd/
│ └── polymarket-go-mcp/
│ └── main.go # CLI entry point
├── internal/
│ ├── mcp/ # MCP protocol implementation
│ ├── gamma/ # Gamma API client
│ ├── data/ # Data API client
│ └── config/ # Configuration management
├── pkg/
│ └── utils/ # Utility functions
├── docs/ # Documentation
├── scripts/ # Build scripts
└── README.md
环境变量
| 变量 | 描述 | 默认值 |
|---|---|---|
LOG_LEVEL |
日志级别(调试、信息、警告、错误) | info |
GAMMA_API_BASE |
Gamma API基础URL | https://gamma-api.polymarket.com |
DATA_API_BASE |
数据API基础URL | https://data-api.polymarket.com |
CACHE_ENABLED |
启用响应缓存 | true |
CACHE_TTL |
缓存生存时间 | 10m |
贡献
我们欢迎捐款!请查看我们的 贡献指南 了解详情。
- 分叉存储库
- 创建要素分支:
git checkout -b feature/amazing-feature - 提交您的更改:
git commit -m 'Add amazing feature' - 推到分支:
git push origin feature/amazing-feature - 打开拉取请求
许可证
此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。
支持
致谢
- 模型上下文协议 -MCP规范
- Polymarket -预测市场平台
- API伽马 -API市场数据
- 数据API -历史数据API
由以下材料制成❤️ Go和MCP社区
