Yapay zeka ajanlarına kanıta dayalı takviye araştırması, dozaj, güvenlik ve etkileşim analizi araçları sağlar.
Ayrıca bilinen adı DrBaher/supstack-cli, supstack-cli, @supstack/cli
- Yıldızlar
- 0
- Araçlar
- —
- İndirmeler, 30 gün
- —
- En son sürüm
- 0.18.2
- Son commit
- 15 Kas 2026
- Lisans
- MIT
supstack MCP nedir?
supstack bir MCP sunucusudur. Yapay zeka ajanlarına kanıta dayalı takviye araştırması, dozaj, güvenlik ve etkileşim analizi araçları sağlar.
Özet, projenin README dosyasından oluşturuldu
supstack MCP sunucusu hakkında
supstack, yapay zeka ajanlarına kanıta dayalı takviye araştırması ve güvenlik analizi sunar. Bir public API üzerinde ince bir istemci (thin client) olarak çalışarak kullanıcıların takviye dozajı, araştırma çalışmaları ve takviyeler, ilaçlar veya belirli biyolojik yollar arasındaki potansiyel etkileşimler hakkında bilgi almasına olanak tanır. Sunucu, stdio üzerinden yerel olarak çalıştırılabilir; bu da onu Claude Desktop veya Claude Code gibi istemcilerle uyumlu hale getirir.
Kullanıcılar; araştırma, arama ve takviyeleri karşılaştırma gibi salt okunur görevler için araç setine anonim olarak erişebilirler. Daha kişiselleştirilmiş yetenekler için kullanıcılar; profil yönetimi, kişiselleştirilmiş öneriler ve kullanım takibi gibi hesap kapsamlı araçlara erişmek üzere giriş yapabilirler. Sistem, hız sınırlarını (rate limits) yönetmek için yerleşik önbelleğe alma özelliğine sahiptir ve otomatize iş akışları için makine tarafından okunabilir JSON çıktısını destekler. Takviyelerin farklı uygulama biçimlerinin (örneğin enjeksiyon yolu gibi) güvenlik tavsiyelerini nasıl değiştirebileceğini kontrol etmek için özel araçlar sunar.
Neler yapabilirsiniz
- 1Takviye güvenliğini analiz edinBelirli bir takviyenin reçeteli bir ilaçla veya biyolojik bir yolla etkileşime girip girmediğini kontrol etmesi için ajana komut verin.
- 2Farklı takviyeleri karşılaştırınAralarındaki farkları anlamak için iki farklı takviye arasında doğrudan bir karşılaştırma talep edin.
- 3Klinik kanıtları araştırınYapay zekanın belirli bir sağlık hedefiyle ilgili randomize kontrollü çalışmalar veya araştırma özetleri bulmasını sağlayın.
- 4Takviye rejimlerini kişiselleştirinKişisel sağlık profilinize dayalı takviye önerileri almak için hesaba bağlı araçları kullanın.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
supstack MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a eklesupstack MCP'yi Claude Code içine yükleyin
$ claude mcp add supstack-cli -- npx -y @supstack/clisupstack MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"supstack-cli": {
"command": "npx",
"args": [
"-y",
"@supstack/cli"
]
}
}
}supstack MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"supstack-cli": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@supstack/cli"
]
}
}
}supstack MCP'yi VS Code CLI içine yükleyin
$ code --add-mcp '{"name":"supstack-cli","type":"stdio","command":"npx","args":["-y","@supstack/cli"]}'supstack MCP'yi Claude Desktop içine yükleyin
claude_desktop_config.json
{
"mcpServers": {
"supstack-cli": {
"command": "npx",
"args": [
"-y",
"@supstack/cli"
]
}
}
}supstack MCP'yi Codex içine yükleyin
$ codex mcp add supstack-cli -- npx -y @supstack/clisupstack MCP'yi Codex config.toml içine yükleyin
~/.codex/config.toml
[mcp_servers.supstack-cli] command = "npx" args = ["-y", "@supstack/cli"]
supstack MCP'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user supstack-cli npx -- -y @supstack/clisupstack MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"supstack-cli": {
"command": "npx",
"args": [
"-y",
"@supstack/cli"
]
}
}
}Otomatik kontroller
Çalıştırıldı 14 Kas 2026Tam rapor →Otomatik kontrollerimizden geçti. Bu bir güvenlik denetimi değildir: kodu okuyun ve sunucuya ihtiyaç duyduğu en dar erişimi verin. Kontroller nasıl çalışır
- Kaynak deposu bağlantılı ve erişilebilirdrbaher/supstack-cli is public and reachablegithub.com/drbaher/supstack-cli ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyor@supstack/cli names drbaher/supstack-cli as sourcenpmjs.com/package/@supstack/cli ↗Geçti
- Derleme kökeni (Sigstore onayı)Sigstore attestation for @supstack/clinpmjs.com/package/@supstack/cli/v/0.18.2#provenance ↗Geçti
- Açık kaynak lisansı (OSI)MITspdx.org/licenses/MIT.html ↗Geçti
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-11-12github.com/drbaher/supstack-cli ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilNo popular package one edit away from @supstack/cliGeçti
- Pakette veya bağımlılıklarında kritik uyarı yok100 resolved dependencies checked; no critical advisoryosv.dev ↗Geçti
- Modele yönelik gizli talimat yok0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişKontrol edilmedi
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorKontrol edilmedi
@supstack/cli
Evidence-based supplement intelligence in your terminal — and an MCP server for AI agents.
A thin client over the public SupStack API. Read-only, no account required. One capability registry powers both the CLI and the MCP server.
Status: Phase 2 (accounts) in progress. All read commands below work, plus an MCP server and
login/whoami. Install withnpm install -g @supstack/cli.
Install
# Homebrew (macOS / Linux)
brew install drbaher/supstack/supstack
# or npm
npm install -g @supstack/cli
# or run without installing
npx -y @supstack/cli define adaptogen
Then enable shell completion: supstack completion install.
From source (in this directory): npm install && npm run build && node dist/index.js define adaptogen.
Usage
supstack research magnesium --protocol # full evidence summary for one supplement
supstack search --goal deep-sleep -n 5 # search by name or filter
supstack compare magnesium glycine # 2–3 head-to-head
supstack studies "sleep" --type rct # research library
supstack interactions caffeine l-theanine --pathway # interaction check (deep pair analysis)
supstack interactions magnesium potassium --medication lisinopril # supplement × drug check
supstack interactions calcium --medication ibandronate --route injection # the form changes the advice
supstack stack add magnesium --dose 400mg --timing bedtime # local stack (+ dose/timing/brand)
supstack stack sync # sync local ⇄ your account (login required)
supstack goals --category sleep # list goal ids (for rate/recommend)
supstack rate --goals deep-sleep,sharpen-focus # grade your stack A–F by goal coverage
supstack experiments start magnesium deep-sleep # run an N-of-1 experiment (requires login)
supstack export --format md # export your stack
supstack define bioavailability # glossary lookup
supstack <command> --json # machine-readable output on any command
supstack --help
Account (Phase 2)
supstack login # sign in via device-code flow (opens the browser to confirm)
supstack whoami # show the signed-in account
supstack logout # sign out and revoke this device's token
login shows a one-time code, opens https://supstack.me/activate, and finishes
once you approve in the browser. The token lives in ~/.supstack/config.json
(0600). Reads work fully anonymously — an account unlocks personalized features.
Once logged in, sync your stack with your account:
supstack stack pull # local ← your account
supstack stack push # local → your account (keeps dosage/timing/brand for kept items)
supstack stack sync # additive merge of both; preserves existing cloud metadata
supstack profile # view your health profile
supstack profile set --age 35 --sex male --weight 80 --weight-unit kg
supstack profile set --smoking former # never | former | current — gates beta-carotene
supstack recommend # personalized picks from your goals + stack
supstack experiments list # your N-of-1 experiments + verdicts
supstack track log # log today's stack as taken
supstack track adherence # your adherence rate, streak, per-supplement
As an MCP server
supstack mcp # stdio MCP server exposing all capabilities as tools
This gives an agent the full SupStack toolset. Read-only (no account needed):
supstack_research, supstack_search, supstack_compare, supstack_studies,
supstack_interactions, supstack_stack, supstack_rate_stack, supstack_export,
supstack_define.
Account-scoped tools are also exposed — supstack_recommend,
supstack_profile_get / supstack_profile_set, supstack_experiments_list /
supstack_experiments_get, supstack_track_log, supstack_track_adherence
(plus cloud supstack_stack pull/push/sync). These require the user to be signed
in (supstack login, or a SUPSTACK_TOKEN); without a token they return a clear
"not logged in" error rather than failing. Mutating tools (profile_set,
track_log) are flagged readOnlyHint: false for the agent.
Claude Code (one command):
claude mcp add supstack -- supstack mcp
Claude Desktop — add to claude_desktop_config.json
(macOS: ~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"supstack": {
"command": "supstack",
"args": ["mcp"]
}
}
}
Or run it without a global install via
"command": "npx", "args": ["-y", "@supstack/cli", "mcp"]. To use a local checkout, point at the built entrypoint —"command": "node", "args": ["/absolute/path/to/supstack-cli/dist/index.js", "mcp"](runnpm run buildfirst).
Configuration
| Env var | Default | Purpose |
|---|---|---|
SUPSTACK_API_URL |
https://supstack.me/api/v1 |
API base URL (override for local dev) |
SUPSTACK_API_KEY |
— | Optional API key (anonymous works at 60/min/IP) |
SUPSTACK_CACHE_TTL |
3600 |
Response cache TTL in seconds |
SUPSTACK_NO_CACHE |
— | Set to disable the response cache |
SUPSTACK_TIMEOUT |
20 |
Per-request timeout in seconds (or use --timeout) |
SUPSTACK_HOME |
~/.supstack |
Directory for config, stack, and cache |
SUPSTACK_TOKEN |
— | Override the stored account token (from supstack login) |
SUPSTACK_NO_ANON_TOKEN |
— | Disable auto-minting of the anonymous instant-token |
SUPSTACK_NO_UPDATE_CHECK |
— | Disable the "update available" notice (also honours NO_UPDATE_NOTIFIER) |
NO_COLOR |
— | Disable ANSI colour |
FORCE_COLOR |
— | Force ANSI colour on (even when piped) |
Global flags available on any command: --json, --no-cache, --timeout <seconds>, --color / --no-color, -q, --quiet.
supstack auth set-key <key> persists a key to ~/.supstack/config.json (written 0600).
Response cache
Read-only API responses are cached under ~/.supstack/cache/ (1-hour TTL by
default) to keep repeat lookups well under the 60/min rate limit. Bypass it per
command with --no-cache, or manage it with supstack cache clear /
supstack cache path. The cache is bounded (oldest entries pruned past a cap).
Shell completion
One-step install for your current shell (writes the script and wires your rc file
idempotently; uninstall reverses it):
supstack completion install # detects bash | zsh | fish from $SHELL
…or generate the script yourself:
supstack completion bash >> ~/.bashrc
supstack completion zsh > "${fpath[1]}/_supstack"
supstack completion fish > ~/.config/fish/completions/supstack.fish
Completions are dynamic — the script forwards what you've typed to
supstack __complete, which offers the right thing for the position:
- top-level commands and sub-actions (
stack <TAB>→add remove list pull push sync) - supplement slugs where a slug is expected (
research <TAB>,compare a <TAB>,stack add <TAB>,track log <TAB>) - goal ids after
search --goal <TAB>
Slug/goal lists are fetched once from the API and cached under
~/.supstack/completion/ (24-hour TTL). Pre-warm or refresh them with:
supstack completion refresh
Exit codes
Commands exit with a semantic code so scripts and MCP wrappers can branch on the kind of failure:
| Code | Meaning |
|---|---|
0 |
Success |
1 |
Generic error (incl. 5xx) |
2 |
Auth required/rejected (not logged in, 401, 403) |
3 |
Not found (404) |
4 |
Rate limited (429) |
5 |
Network failure / timeout |
6 |
Invalid input (bad/missing args or flags, unknown command, schema validation, 400/422) |
Develop
npm test # unit tests (mocked fetch)
npm run type-check # tsc --noEmit
npm run build # tsup → dist/
See CLAUDE.md for the capability pattern and how to add a command.
License
MIT
supstack MCP soruları
supstack MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add supstack-cli -- npx -y @supstack/cli komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
supstack MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
supstack'i Claude Desktop ile nasıl kullanabilirim?
'supstack mcp' komutunu kullanarak veya npx aracılığıyla claude_desktop_config.json dosyanıza ekleyebilirsiniz.