内容
# `@stellar-light/scout-mcp`
> 星际侦察，作为MCP服务器。在Claude桌面版、Cursor、ChatGPT、Gemini、Cline、Continue、Zed或任何[模型上下文协议](https://modelcontextprotocol.io)客户端中使用。
公开了15种工具，封装了[stellarlight.xyz](https://stellarlight.xyz)的公共API——与[`stellar-scout`](https://stellarlight.xyz/scout)技能相同的數據，作为原生可调用函数，适用于任何MCP兼容的AI客户端。
```
npx @stellar-light/scout-mcp
```
---
## 你可以询问
**研究、审计和原始资料**
> *"Blend的预言机报告了哪些审计发现？*"
> 调用`search_research`，并设置`source=audit`。返回带有严重性标签的区块，引用Certora / OtterSec / Halborn审计，并附有内联发现ID。
> *"Stellar的开发者数量与L1相比如何？*"
> 调用`search_research`，并设置`source=ec-developer-report`。返回2019-2023年的Electric Capital数据。
**项目发现 + 想法验证**
> *"是否有人在Stellar上为非洲建立了稳定币退出通道？*"
> 调用`search_projects`。返回具有SCF状态、黑客马拉松排名和分级匹配模式的项目，以便您了解结果的可信度。
> *"Stellar上目前最拥挤的类别是什么？*"
> 调用`get_clusters`。返回1-10的对数缩放拥挤度评分，涵盖各个类别。
> *"显示Stellar的存储库/开源代码，用于zk证明。*"
> 调用`search_repos`。返回约1900个索引的GitHub存储库，按repoScore（新鲜度+关注度+黑客马拉松/SCF/构建者权威）排名，并具有同义词扩展和语言过滤器。
**黑客马拉松 + SCF准备**
> *"有哪些开放的Stellar黑客马拉松我可以参加？*"
> 调用`get_hackathons`，并设置`status=upcoming`。返回精选的DoraHacks活动；当没有匹配时，备用BuildOnStellar / stellarlight / DoraHacks实时频道。
> *"比较Stellar Hacks：Agents vs Chile Ideatón。*"
> 调用`compare_hackathons`。返回并排比较，并附有差异注释（奖品分布、黑客数量、每个获奖者的奖品）。
**SCF RFP**
> *"是否有针对实时价格API的开放SCF RFP？*"
> 调用`get_rfps`，并设置`status=open`。返回具有活动SCF轮次标记的季度感知列表。
**宏观生态系统**
> *"Stellar迄今为止SCF分配的总资金是多少？*"
> 调用`analyze_ecosystem`。返回跨黑客马拉松+项目+资金轮次的汇总分析。
---
## 安装
### Claude 桌面版
添加到 `~/Library/Application Support/Claude/claude_desktop_config.json`（macOS）或 `%APPDATA%\Claude\claude_desktop_config.json`（Windows）：
```json
{
"mcpServers": {
"stellar-scout": {
"command": "npx",
"args": ["-y", "@stellar-light/scout-mcp"]
}
}
}
```
重启Claude桌面版。15个Scout工具将出现在斜杠菜单中。
### Cursor
在您的Cursor MCP配置（`Cursor Settings → MCP`）：
```json
{
"mcpServers": {
"stellar-scout": {
"command": "npx",
"args": ["-y", "@stellar-light/scout-mcp"]
}
}
}
```
### ChatGPT（自定义GPT）
使用ChatGPT自定义GPT的[官方MCP连接器](https://platform.openai.com/docs/mcp)，并指向此包。使用相同的npx命令。
### Continue、Cline、Zed等
任何遵循MCP规范的客户端都可以使用。指向 `npx -y @stellar-light/scout-mcp`。
### 自托管（可选）
```bash
git clone https://github.com/Stellar-Light/scout-mcp
cd scout-mcp
pnpm install
pnpm build
# 将您的客户端指向：node /path/to/scout-mcp/dist/index.js
```
---
## 工具
所有15种工具都封装了stellarlight.xyz的公共API。它们受到速率限制，但不需要API密钥。
| 工具 | 功能 |
|------|--------------|
| `search_research` | 对4541区块的Stellar研究语料库（SEPs、SCF手册、开发者文档、论文、lumenloop、审计、EC报告）进行向量搜索。使用`source=audit`表示安全，使用`source=ec-developer-report`表示生态系统统计。 |
| `get_hackathons` | 列出精选的Stellar黑客马拉松和实时DoraHacks活动。状态范围查询包括空时的备用频道。 |
| `get_hackathon` | 一个黑客马拉松的完整详细信息（提交、获奖者、奖品轨道、状态漏斗）。 |
| `compare_hackathons` | 2-5个黑客马拉松的并排比较，附有差异注释。 |
| `get_builders` | Stellar Passport构建者目录。按位置、技能、SCF层级过滤。 |
| `search_projects` | 跨741+精选项目的先前艺术/竞争者查找。分级匹配模式（严格→宽松→多数）在`.meta.matchMode`中显示。 |
| `search_repos` | 代码引用索引：约1900个索引和评分的Stellar GitHub存储库，按repoScore排名。具有同义词扩展和`language` / `minScore`过滤器。项目目录下的存储库层。 |
| `get_rfps` | 开放和关闭的Stellar RFP（SCF资助的赞助商简介）。季度感知。 |
| `list_skills` | [skills.stellar.org](https://skills.stellar.org)的7种官方技能目录。 |
| `get_skill` | 一个SDF技能的完整内容。 |
| `get_leaderboard` | 生态系统开发者活动（28天活跃开发者、提交、peer L1比较）。 |
| `get_status` | Scout API健康状况和每个数据源的新鲜度 + 端点枚举。 |
| `submit_feedback` | 技能内的反馈循环。落在stellarlight的策划者队列中。 |
| `get_clusters` | 具有1-10的对数缩放拥挤度评分的项目主题集群。 |
| `analyze_ecosystem` | 跨事件分析汇总（黑客马拉松+项目+资金+状态漏斗）。 |
---
## 配置
可选环境变量：
```
SCOUT_API_BASE # API基准URL（默认：https://stellarlight.xyz）
SCOUT_USER_AGENT # 每次调用发送的用户代理（默认：stellar-scout-mcp/1.0.0）
```
在针对`http://localhost:3000`运行stellarlight时，适用于本地开发。
---
## 配套：`Stellar-Light/stellar-scout`
此MCP服务器适用于支持MCP的客户端。如果您在Claude Code、Codex、OpenClaw、Cursor（技能模式）或加载`SKILL.md`文件的任何代理中，可以安装SKILL.md：
```bash
npx skills add Stellar-Light/stellar-scout
```
两个界面都调用相同的后端。
---
## 许可证
MIT。由[stellarlight.xyz](https://stellarlight.xyz)为Stellar构建者构建为公共产品。
---
## 链接
- [stellarlight.xyz/scout](https://stellarlight.xyz/scout) — Scout着陆页
- [GitHub：Stellar-Light/stellar-scout](https://github.com/Stellar-Light/stellar-scout) — SKILL.md镜像
- [skills.stellar.org](https://skills.stellar.org) — SDF的7种官方Stellar技能
- [模型上下文协议](https://modelcontextprotocol.io) — 本实现规范
