预测市场数据服务

一个基于Go语言的MCP服务器,用于通过Gamma API和Data API访问Polymarket预测市场数据,提供实时市场数据、搜索、历史价格和投资组合跟踪等功能。

  • by ivanzzeth
  • Go
  • 本地部署
  • 更新于
在 GitHub 查看 ivanzzeth/polymarket-go-mcp

使用说明

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

贡献

我们欢迎捐款!请查看我们的 贡献指南 了解详情。

  1. 分叉存储库
  2. 创建要素分支: git checkout -b feature/amazing-feature
  3. 提交您的更改: git commit -m 'Add amazing feature'
  4. 推到分支: git push origin feature/amazing-feature
  5. 打开拉取请求

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

支持

致谢


由以下材料制成❤️ Go和MCP社区