io.github.madjik-io/mcp-server
Quantum-finance market metrics for AI agents, computed by the Black Belt Labs engine.
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
madjik-mcp-serverclaude mcp add io-github-madjik-io-mcp-server -e 'MADJIK_API_KEY=<your madjik_api_key>' -- npx -y madjik-mcp-server@2.0.2
{
"mcpServers": {
"io-github-madjik-io-mcp-server": {
"command": "npx",
"args": [
"-y",
"madjik-mcp-server@2.0.2"
],
"env": {
"MADJIK_API_KEY": "<your madjik_api_key>"
}
}
}
}
متغيرات البيئة
MADJIK_API_KEYإلزامي سري Madjik API key (get one at https://api.madjik.io/pricing)
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
المحتويات
@blackbeltlabs/mcp-server
Quantum-finance intelligence for AI agents.
Connect any MCP-compatible AI agent to Black Belt Labs metrics — quantum-computed portfolio optimisation, VaR simulation, AI-enhanced regime detection, sentiment, and cross-asset risk signals.
Requirements
- Node.js ≥ 18
- A Black Belt Labs API key (
bbl_live_...orbbl_test_...) — get one at blackbeltlabs.fi
Note: Madjik API keys (
mk_...) are not accepted. BBL keys are issued separately at blackbeltlabs.fi.
Quickstart
Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"blackbeltlabs": {
"command": "npx",
"args": ["-y", "@blackbeltlabs/mcp-server"],
"env": {
"BLACKBELTLABS_API_KEY": "bbl_live_your_key_here"
}
}
}
}
Restart Claude Desktop. You can now ask: "What is the current quantum VaR estimate from Black Belt Labs?"
Other MCP clients
BLACKBELTLABS_API_KEY=bbl_live_your_key npx @blackbeltlabs/mcp-server
Available Tools
| Tool | Description |
|---|---|
get_metric | Fetch any single metric by ID (e.g. ME10021) |
get_quantum_metrics | Fetch all quantum-computed metrics (ME10021, ME10022) |
get_ai_metrics | Fetch all AI-enhanced metrics (ME10016, ME10017, ME10019, ME10020, ME10010) |
get_risk_snapshot | Composite risk view: QC VaR + leverage + liquidation + correlation |
list_metrics | Browse catalog by category or computation method |
search_metrics | Search by keyword (e.g. quantum, sentiment, regime) |
Key Metrics
| ID | Name | Method |
|---|---|---|
| ME10021 | Portfolio Optimisation | ⚛️ Quantum (QAOA) |
| ME10022 | Risk Simulation — VaR | ⚛️ Quantum (QAE) |
| ME10017 | Sentiment Index | 🤖 AI (Gemini) |
| ME10019 | Market Narrative | 🤖 AI (Gemini) |
| ME10016 | Regime Detection | 🤖 AI + HMM |
| ME10002 | Leverage Stress Index | Classical |
| ME10004 | Liquidation Cascade Risk | Classical |
License
MIT © Black Belt Labs
Disclaimer
Madjik metrics are informational market indicators computed by the Black Belt Labs engine. They are not investment advice, an offer, or a recommendation to buy or sell any asset. Quantum-computed metrics run on Qiskit simulators (hardware-ready circuit designs).
الأسئلة الشائعة
ما هو io.github.madjik-io/mcp-server؟
Quantum-finance market metrics for AI agents, computed by the Black Belt Labs engine.
كيف أثبّت io.github.madjik-io/mcp-server؟
يعمل على جهازك. في Claude Code: claude mcp add io-github-madjik-io-mcp-server -e 'MADJIK_API_KEY=<your madjik_api_key>' -- npx -y madjik-mcp-server@2.0.2. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج io.github.madjik-io/mcp-server إلى مفتاح API؟
نعم. يتطلب MADJIK_API_KEY، وتضبطها في إعداداته.
هل io.github.madjik-io/mcp-server مفتوح المصدر؟
نعم. شيفرته متاحة على GitHub بترخيص MIT.
من يصون io.github.madjik-io/mcp-server؟
ينشره madjik-io. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.