sc-search
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
SC Search — 星际公民本地问答助手
在 豆包(豆包工作)或其它支持 MCP 的 AI 客户端里,用本地数据库快速查《星际公民》物价、任务/蓝图、飞船参数和中英俗称,不必每次都翻网页。
适合:边玩边问「黄金哪卖贵」「大白鲨载货多少」「这个任务给什么蓝图」这类事实问题。
你需要准备什么
项目 | 说明 |
电脑 | macOS / Windows / Linux 均可 |
Python | 3.11 或更高 |
AI 客户端 | 推荐 豆包(桌面端「豆包工作」,支持自定义 MCP 连接器);也可用 Cursor 等任意 STDIO MCP 客户端 |
UEX 账号(可选) | 要查实时跑商物价时需要;只查任务/飞船/Wiki 可不配 |
Related MCP server: sql-specialist-mcp
5 分钟快速开始
下面命令在项目根目录执行(本仓库解压/克隆后的文件夹)。
1. 安装
python3 -m venv .venv
# macOS / Linux
source .venv/bin/activate
# Windows(PowerShell)
# .venv\Scripts\Activate.ps1
pip install -e .2. 配置(查物价时需要)
打开 UEX My Apps,登录并创建一个 App,复制 App Access Token。
在项目里复制环境文件并填入 Token:
cp config/.env.example config/.env编辑 config/.env:
UEX_API_TOKEN=粘贴你的TokenSC_SEARCH_DB 可以留空(默认用 data/sc_knowledge.sqlite)。
3. 初始化并下载数据
推荐:一键脚本(首次或补丁后都可用,大约几分钟,视网速而定):
# macOS / Linux
chmod +x scripts/sync_all.sh
./scripts/sync_all.sh# Windows PowerShell
.\scripts\sync_all.ps1脚本会依次执行:init → uex → scmdb → scw → wiki → aliases → zh。
若未配置 UEX_API_TOKEN,物价同步会跳过,其它源照常进行。
也可以手动逐步执行:
python -m sc_search.ingest init
python -m sc_search.ingest sync uex # 跑商物价 + 飞船游戏内购价(需 Token)
python -m sc_search.ingest sync scmdb --channel live # 任务 / 蓝图奖励
python -m sc_search.ingest sync scw # 飞船参数
python -m sc_search.ingest sync wiki # 英文 Wiki 摘要
python -m sc_search.ingest sync aliases # 民间俗称(大白鲨等)
python -m sc_search.ingest sync zh # 汉化组标准中文译名(global.ini)
python -m sc_search.ingest status4. 接到豆包(推荐)
豆包桌面端「豆包工作」支持自定义 STDIO MCP;自定义连接器仅在本地电脑任务里可用(不要选云电脑)。
先确认本机能启动 MCP(仓库根目录):
# macOS / Linux
./scripts/run_mcp.sh
# 或
.venv/bin/python -m sc_search.mcp_server# Windows PowerShell
.\scripts\run_mcp.ps1
# 或
.\.venv\Scripts\python.exe -m sc_search.mcp_server能挂起等待(stdio)说明服务正常,用 Ctrl+C 结束后再去豆包里配。
打开豆包 → 技能 · 连接器 · 伙伴(或「插件 · 技能 · 伙伴」)→ 新建 → 新建自定义连接器,按下面填写:
字段 | 填写 |
服务器名称 |
|
传输类型 | STDIO |
命令 | 绝对路径:macOS/Linux 用 |
参数 | 逐项添加: |
环境变量 |
|
更省事:命令改填启动脚本、参数留空——macOS/Linux:scripts/run_mcp.sh(先 chmod +x);Windows:scripts\run_mcp.ps1(若豆包要求 .exe/解释器,命令填 powershell.exe,参数填 -File、C:\绝对路径\SC_Search\scripts\run_mcp.ps1)。
保存后确认连接器已启用;新建工作任务,运行位置选 本地电脑,在连接器里勾选
sc-search。若首次提示运行失败,在连接器列表里点一次「重新启动」。
也可参考官方说明:豆包工作 · 插件 / 自定义连接器。
cp .cursor/mcp.json.example .cursor/mcp.json编辑 .cursor/mcp.json(已被 git 忽略,勿提交本机路径),把其中的绝对路径改成你的仓库路径后,在客户端重载 MCP。也可把 command 换成 scripts/run_mcp.sh。
5. 开始提问
回答链路:Agent 理解意图与槽位 → sc-search MCP 检索证据 → Agent 依据证据成文(简单题可直接 sc_answer)。
在豆包对话里直接问即可(建议显式选中 sc-search 连接器)。Agent 应优先调用本项目的工具,例如:
你想问的 | 大致会用到的工具 |
(任意 SC 事实问题,默认) |
|
(只要路由/调试) |
|
「黄金在哪卖贵?」 |
|
「Lorville 都卖什么价?」 |
|
「大白鲨是哪艘船?」 |
|
「Carrack 载货 / 厂家?」 |
|
「红风 Junior 能接什么任务?」 |
|
「Carrack 是什么船?」 |
|
「数据是什么时候同步的?」 |
|
也可以自己先确认工具是否正常:问一句「用 sc-search 查一下黄金卖出价」。
游戏更新后怎么办
补丁或物价变化后,再跑一次一键脚本即可:
./scripts/sync_all.sh # macOS / Linux
# .\scripts\sync_all.ps1 # Windows也可以只同步某一源,例如 PTU:python -m sc_search.ingest sync scmdb --channel ptu。
MCP 不会自动改库,避免误触发大流量下载;同步请在终端手动执行。
现在能查什么 / 还不能指望什么
本地库比较擅长:
货物买卖价、终端报价(来自 UEX,社区众包,可能有误差)
飞船游戏内购点与 aUEC(同属
sync uex:UEXvehicles_purchases_prices_all)任务赏金、蓝图奖励池、部分物品奖励(SCMDB)
飞船参数与中英描述片段(Star Citizen Wiki API)
Wiki 英文摘要全文检索
汉化组标准中文译名(如 克拉克 → Carrack;来自 汉化组 global.ini,CC BY-NC-SA 4.0,仅个人非商用)
民间俗称(如大白鲨 → Carrack;维护在
data/seed_aliases.json)
仍建议开网页 / 游戏内确认的:
Erkul 精细配装与 DPS
采矿阻力、激光头计算
Spectrum 论坛、需登录的官方内容
中文维基长文(
citizenwiki.cn对自动程序常有 Cloudflare 拦截;标准译名已用汉化组 ini 覆盖)
回答里若带了 game_version / 同步时间,请以那一行判断数据新不新。UEX 返回的版本号有时会偏旧,以同步时间和实机为准。
常见问题
Q:没有 UEX Token 能用吗?
能。跳过 sync uex,任务、飞船参数、Wiki、俗称照样可用;只是没有跑商物价和飞船游戏内 aUEC 购点。
Q:Token 安全吗?
放在 config/.env,已被 git 忽略,不要发到聊天或公开仓库。
Q:MCP 里看不到 sc-search / 发现失败?
豆包:确认传输类型是 STDIO、命令为 Python/脚本的绝对路径、任务环境是本地电脑,连接器已启用;失败时点「重新启动」。
Cursor 等:确认
.cursor/mcp.json用的是绝对路径的.venv/bin/python(或run_mcp.sh)。依赖需为 MCP Python SDK 1.x(
mcp>=1.1,<2,FastMCP);2.x 在部分宿主上会「live tool discovery」失败。终端自检:
./scripts/run_mcp.sh # macOS / Linux
# .\scripts\run_mcp.ps1 # Windows
# 或 .venv/.../python -m sc_search.mcp_server能启动(stdio 等待)说明服务本身正常,剩下是客户端重载 / 重新启用连接器。
Q:查询结果是空的?
先跑 python -m sc_search.ingest status,确认对应源是 ok。空库时先 init 再 sync。
Q:我想加自己的俗称?
编辑 data/seed_aliases.json,再执行:
python -m sc_search.ingest sync aliases给开发者 / Agent 的文档
Agent 入口:
AGENTS.md问答编排:
ORCHESTRATION.md站点清单:
SOURCES.md
许可证
本仓库代码与自有文档以 MIT License 发布。
第三方数据需单独遵守其原许可(同步到本地库时不会随本仓库分发 SQLite 数据):
来源 | 用途 | 许可要点 |
| CC BY-NC-SA 4.0,仅个人非商用 | |
UEX / SCMDB / Star Citizen Wiki 等 | 物价、任务、飞船参数、摘要 | 以各站点条款为准;本工具仅作个人游戏辅助 |
本项目与 Cloud Imperium Games / RSI 无官方关联;数据来自社区站点,仅供个人学习与游戏辅助。
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Query, explore, and manage your databases through natural conversation.
Store, query, and update structured data from any AI agent
Deterministic knowledge for AI agents: search, fetch, cite and verify a 48M-entry knowledge base.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables AI agents to interact with local SQLite databases with full CRUD, schema introspection, foreign key relations, generated columns, and multi-format import/export (CSV, JSON, XLSX) through natural language.2610 npmMIT
- FlicenseNot gradedqualityDmaintenanceEnables natural-language querying of a SQLite database through a locally served, fine-tuned text-to-SQL model exposed as an MCP tool, offering fast and cost-free SQL generation and execution.1-
- AlicenseNot gradedqualityBmaintenanceExposes a local SQLite-based memory and knowledge base as standard MCP tools, enabling AI clients to search content, recall memory fragments, and query entity relationships through natural language.2MIT
- FlicenseNot gradedqualityBmaintenanceEnables AI clients to interact with SQLite databases using natural language, translating prompts into structured queries and returning clean results for analysis and reporting.-