MCP石勘院
  
用于RIEstat Data API的模型上下文协议（MCP）服务器，提供 IP地址和前缀的网络信息。
\[！小心\] 此MCP服务器目前正在积极开发中。它可能不稳定 并且可能会发生变化。请谨慎使用。
关于RIEstat
RIPEEstat是一家大型信息服务机构，也是RIPE NCC的开放数据 平台。它提供有关IP地址空间和自治系统的基本数据 数字（ASN），以及特定主机名和 国家。这项服务是网络运营商、安全部门的宝贵工具 研究人员以及任何对其结构和性能感兴趣的人 互联网，提供路由、注册数据、DNS和 地理信息。
有关更多信息，请访问 RIEstat网站 和 咨询 API数据文件.
用例
使用MCP客户端，您可以利用大型语言模型（LLM）进行查询 RIPEStat使用自然语言。这意味着你可以问一些复杂的问题 网络信息、IP地址、ASN和其他RIPEStat数据，无需 以了解底层API或查询语法。客户翻译您的自然语言 将语言查询转换为适当的API调用，使其更容易、更直观 访问和分析RIPEStat数据以进行研究、故障排除或网络 管理任务。
调查工作流程
有关示例、调查工作流程和使用模式，请参见 提示.
特性
此MCP服务器通过以下方式提供对RIEstat Data API的智能访问 7个可直接访问的工具:
整合语义工具 （6个自动检测资源类型和路由请求的工具）：
- 🔍 调查资源 -具有自动检测和智能路由的主要调查工具
- 📊 分析路由 -支持时间框架的BGP和路由分析
- 📋 queryRegistry -注册表和管理数据查找
- 🔒 validateSecurity -安全和合规检查（RPKI、滥用联系人）
- 🌐 探索关系 -网络拓扑和关系
- 🌍 searchByLocation -按国家分列的地理分析
实用工具 （1个工具）：
- 🔧 获取WhatsMyP -获取呼叫者的公共IP地址
\[！注意\] 只有这7个工具可以直接调用。单个RIEstat端点（如getNetworkInfo,getASOverview等等）是内部实现细节并且由合并工具基于资源类型和请求的操作自动调用。
资源检测：自动识别IP地址、前缀、ASN和国家代码，无需明确的类型规范。
作业路线：根据资源类型和上下文将语义操作映射到最相关的RIEstat端点。
看 端点性 了解底层RIEstat端点的实施状态。
建筑原理
HTTP传输选择：此服务器通过以下方式实现MCP 可流式传输的HTTP 而不是stdio传输，支持作为独立网络进行部署 多个MCP客户端可以同时访问而无需进程的服务 在头顶产卵。
遗留协议回退：服务器保持向后兼容性 已弃用的传输。
并发请求管理：基于信号量的速率限制操作 每个服务器实例而不是每个客户端连接，管理RIPE API配额 跨多个并发会话。
\[！警告\] 在当前阶段，此MCP服务器不提供身份验证。最初的 2024-11-05发布的MCP版本不支持授权。然而， 在2025-03-26更新中，MCP协议引入了基于OAuth 2.1的 授权机制。它尚未被广泛采用，可能会成为主题 因此，我们建议使用防火墙或其他 本地MCP解决方案，如MCPProxy，用于限制对服务器的访问。
安装
先决条件
- 转到1.26.2或更高
- 制造
# Clone the repository
git clone https://github.com/taihen/mcp-ripestat.git
cd mcp-ripestat
# Install dependencies
make deps
# Build the application
make build用法
# Run the server
./bin/mcp-ripestat
# Run with custom port
./bin/mcp-ripestat --port 8081
# Enable debug logging
./bin/mcp-ripestat --debug
# Show help
./bin/mcp-ripestat --help健康检查端点
服务器提供基本的监控端点：
/status-服务器状态，包括正常运行时间、版本和运行状况信息/warmup-预热端点以防止容器化部署中的冷启动
这些端点对于负载均衡器、监控系统和部署编排至关重要。
MCP协议支持
可流式HTTP传输
•端点：/mcp（流式传输发生在同一请求/响应通道上） •协议：流帧HTTP（根据MCP规范2025-06-18） •状态：所有实施2025-06-18规范的MCP客户端的默认传输 •特点：双向流、增量响应、零拷贝帧
JSON-RPC 2.0端点
•终点：/mcp •协议：JSON-RPC 2.0 •状态：推荐的生产端点（取代REST） •功能：完整的MCP握手、能力协商、工具调用，与Cursor IDE和其他符合MCP的客户端兼容
MCP客户端配置
要在本地使用此MCP服务器，只需复制并粘贴 MCP客户端配置 进入您的MCP客户端
- 光标：macOS/Linux：
~/.cursor/mcp.json - 克劳德代码（本地服务器）:
claude mcp add --transport http ripestat http://localhost:8080/mcp - Codex CLI（本地服务器）:
codex mcp add ripestat --url http://localhost:8080/mcp
演示服务器
演示MCP服务器正在运行 https://mcp-ripestat.taihen.org/mcp.感受 免费试用，但没有正常运行时间的承诺。
从CLI添加演示服务器
使用用户范围使服务器跨项目可用。
克劳德代码：
claude mcp add-json ripestat --scope user '{"type":"http","url":"https://mcp-ripestat.taihen.org/mcp"}'Codex CLI：
codex mcp add ripestat --url https://mcp-ripestat.taihen.org/mcp验证配置：
claude mcp list
codex mcp list使用带有Codex配置文件的演示服务器
Codex从读取MCP服务器定义 ~/.codex/config.toml （全球）或 .codex/config.toml （项目本地），不是来自 mcp-demo.json.
添加此服务器条目：
[mcp_servers.ripestat]
url = "https://mcp-ripestat.taihen.org/mcp"然后重新启动Codex并运行 /mcp 为了验证这一点 ripestat 已连接。
现在，您可以询问以下提示：
Investigate 8.8.8.8 and summarize ownership, routing, and abuse contacts.Analyze routing for AS3333 and show key anomalies.
测试
# Run tests
make test
# Run tests with coverage report
make test-coverage
# Run end-to-end tests
make e2e-test
# Run linters
make lint
# Format code
make fmt
# Clean build artifacts
make clean
# Install dependencies
make deps贡献
欢迎投稿！请阅读 贡献指南 看看你如何参与。
发展
开发过程分为冲刺阶段，每个冲刺阶段都专注于 具体特征。所有过去和功能变化的详细分类账， 按短跑项目划分，可在 冲刺 文档。
\[！注意\] 如果未包含特定功能，请随时打开 问题 讨论它。
许可证
该项目根据MIT许可证获得许可。请参阅 许可证 文件 了解详情。