内容
# 超级商店 MCP
<!-- mcp-name: io.github.deficlow/hyperstore-mcp -->
> 通过 [模型上下文协议](https://modelcontextprotocol.io)，将 6,500+ AI 应用连接到任何 LLM。
[](https://pypi.org/project/hyperstore-mcp/)
[](https://glama.ai/mcp/servers/deficlow/HyperStore-MCP)
[](https://smithery.ai/server/deficlow/hyperstore)
[](https://registry.modelcontextprotocol.io/v0/servers?search=io.github.deficlow/hyperstore-mcp)
[](https://github.com/deficlow/HyperStore-MCP/actions/workflows/ci.yml)
[](LICENSE)
**超级商店** 是由 [HyperGPT](https://hypergpt.ai) 开发的精选的 6,500+ AI 应用目录。
此 MCP 服务器将 [超级商店](https://store.hypergpt.ai) 目录暴露给任何 LLM 客户端 — Claude、ChatGPT、Cursor、Windsurf、Cline、Zed、Gemini，以及其他所有支持 MCP 的客户端。
询问您的 LLM：
> *"给我找一个免费的 AI 工具，可以总结 PDF。*"
> *"比较 ChatGPT、Claude 和 Gemini 的功能。*"
> *"给我展示 5 个带有 API 的顶级图像生成应用。*"
LLM 在后台调用超级商店 MCP，并用最新、精选的结果进行回复。
---
## 您将获得
**13 个工具：**
| 工具 | 用途 |
|---|---|
| `search_apps` | 全文关键词搜索 |
| `ai_search` | 基于嵌入的语义搜索 |
| `get_app` | 完整的应用程序详情（功能、截图、定价） |
| `list_apps` | 分页的应用列表，带有过滤器（类别、定价） |
| `list_categories` | 浏览所有 30+ 类别 |
| `category_apps` | 类别内的应用 |
| `browse_apps` | A-Z 目录列表 |
| `get_homepage` | 趋势 + 顶级类别概览 |
| `get_alternatives` | 应用的精选替代品 |
| `list_audiences` | 受众群体（开发者、律师等） |
| `apps_for_audience` | 适用于某个受众群体的最佳 AI 工具 |
| `list_use_cases` | 使用案例分类法（法律-合同等） |
| `apps_for_use_case` | 适用于某个使用案例的 AI 工具 |
**3 个资源：**
- `hyperstore://app/{slug}` — 任意应用的 Markdown 渲染
- `hyperstore://category/{slug}` — 类别中的顶级应用
- `hyperstore://catalog` — 完整的类别索引
**3 个提示：**
- `find_tool_for_task` — 任务的引导式发现
- `compare_apps` — 应用的并排比较
- `discover_category` — 探索某个主题
---
## 安装
### 选项 A — `uvx`（零安装，推荐）
需要 [uv](https://docs.astral.sh/uv/)。只需一条命令即可完成：
```bash
uvx hyperstore-mcp
```
### 选项 B — `pipx`
```bash
pipx install hyperstore-mcp
hyperstore-mcp
```
### 选项 C — Docker（用于远程托管）
```bash
docker run --rm -p 8080:8080 ghcr.io/deficlow/hyperstore-mcp
# 现在 MCP 可通过 HTTP 流式传输，网址为 http://localhost:8080/mcp
```
### 选项 D — 托管端点（无需安装）
使用我们托管的流式 HTTP 服务器：
```
https://mcp.store.hypergpt.ai/mcp
```
---
## 从您的 LLM 客户端连接
### Claude Desktop
编辑 `~/Library/Application Support/Claude/claude_desktop_config.json`
（macOS）或 `%APPDATA%\Claude\claude_desktop_config.json`（Windows）：
```json
{
"mcpServers": {
"hyperstore": {
"command": "uvx",
"args": ["hyperstore-mcp"]
}
}
}
```
重启 Claude → 工具出现在 🛠 菜单中。
### Claude Code
```bash
claude mcp add hyperstore -- uvx hyperstore-mcp
```
### Cursor
`.cursor/mcp.json`（项目）或 `~/.cursor/mcp.json`（全局）：
```json
{
"mcpServers": {
"hyperstore": {
"command": "uvx",
"args": ["hyperstore-mcp"]
}
}
}
```
### Windsurf
`~/.codeium/windsurf/mcp_config.json`:
```json
{
"mcpServers": {
"hyperstore": {
"command": "uvx",
"args": ["hyperstore-mcp"]
}
}
}
```
### Cline（VS Code）
`settings.json`:
```json
{
"cline.mcpServers": {
"hyperstore": {
"command": "uvx",
"args": ["hyperstore-mcp"]
}
}
}
```
### Zed
`~/.config/zed/settings.json`:
```json
{
"context_servers": {
"hyperstore": {
"command": {
"path": "uvx",
"args": ["hyperstore-mcp"]
}
}
}
}
```
### Gemini CLI
`~/.gemini/settings.json`:
```json
{
"mcpServers": {
"hyperstore": {
"command": "uvx",
"args": ["hyperstore-mcp"]
}
}
}
```
### ChatGPT（Pro / Team / Enterprise）
**设置 → 连接器 → 添加自定义连接器**:
- **名称**: 超级商店
- **MCP 服务器 URL**: `https://mcp.store.hypergpt.ai/mcp`
- **身份验证**: 无
### OpenAI Responses API
```python
from openai import OpenAI
client = OpenAI()
response = client.responses.create(
model="gpt-4.1",
tools=[{
"type": "mcp",
"server_label": "hyperstore",
"server_url": "https://mcp.store.hypergpt.ai/mcp",
"require_approval": "never",
}],
input="给我 3 个免费的 AI 工具，用于编写单元测试。",
)
print(response.output_text)
```
### Anthropic Messages API
```python
from anthropic import Anthropic
client = Anthropic()
response = client.messages.create(
model="claude-opus-4-7",
max_tokens=1024,
mcp_servers=[{
"type": "url",
"url": "https://mcp.store.hypergpt.ai/mcp",
"name": "hyperstore",
}],
messages=[{"role": "user", "content": "5 个顶级 AI 图像生成器？"}],
)
```
查看 [`examples/`](examples/) 以获取所有支持的客户端的即粘贴配置。
---
## 自托管
对于自托管，请使用 [Docker 镜像](#选项-c-docker-用于远程托管)。
对于直接调用而无需 Docker，CLI 接受 `--transport http|sse`
（参见 `hyperstore-mcp --help`）。
---
## 配置
自托管时，可以设置这些环境变量
（参见 [.env.example](.env.example) 以获取完整列表）：
| 变量 | 默认值 | 用途 |
|---|---|---|
| `MCP_HOST` | `0.0.0.0` | 绑定主机（http/sse 传输） |
| `MCP_PORT` | `8080` | 绑定端口（http/sse 传输） |
| `LOG_LEVEL` | `INFO` | 日志级别（`DEBUG`、`INFO`、`WARNING`、`ERROR`） |
---
## 开发
```bash
git clone https://github.com/deficlow/HyperStore-MCP
cd HyperStore-MCP
uv sync --all-extras
uv run pytest
uv run hyperstore-mcp # 标准输入模式，用于本地测试
```
使用官方 **MCP 检查器** 检查正在运行的服务器：
```bash
npx @modelcontextprotocol/inspector uvx hyperstore-mcp
```
---
## 工作原理
超级商店 MCP 是围绕 [超级商店](https://store.hypergpt.ai) 公共
REST API 的薄异步包装器。它是**只读**的 — 无凭证，无写入，无 PII。
为网站提供数据的同时，也为 MCP 服务器提供数据。更新一旦在网站上生效，就会立即在您的 LLM 中生效。
```
LLM 客户端 ──MCP──▶ hyperstore-mcp ──HTTPS──▶ store.hypergpt.ai/api
```
---
## License
MIT © [HyperGPT](https://hypergpt.ai)
