AgentHubAgentHub

xbbg MCP Setup & Guide

MCP ServerMCP RegistryOfficial

io.github.underloam/xbbg-mcp · v1.5.0

Local Bloomberg tools for xbbg users.

View on MCP Registry ↗Repository ↗

Copy the install config on this page first, then verify docs and permissions upstream.

Overview

Local Bloomberg tools for xbbg users. xbbg MCP is a MCP Server listed from MCP Registry. Transports: stdio. This page includes an overview, setup tutorial, install commands, and use cases for Trae, Tongyi Lingma, Cursor, Claude Code, and VS Code.

Use cases

Code review & GitHubCursor essentials

AgentHub Verified AvailabilityTested & Ready

Automated pipeline validated install commands, protocol & client compatibility

Verified At2026-10-04
Install Snippets TestedCLI & JSON config syntax verified
Protocol Handshake ReadyComplies with JSON-RPC 2.0 specifications
Origin Registry ActiveSourced from official-mcp-registry
Verified ClientsClaude Code、Claude Desktop、Cursor 等
Security Tier: A+ 级 · 官方认证推荐 (A+)·Maintained by official/verified teams, audited for standard MCP protocol compliance.
No auto-generated install guide — see the source repository README.

Troubleshooting & Common ErrorsFAQ

Common connection errors and verified fixes for xbbg MCP

Getting 'connection closed' or exit code 1 in Cursor / Claude Code for xbbg MCP?

Usually caused by missing runtime paths or IDE environment inheritance. Fix steps: 1. Verify Node.js 18+ (npx) or Python 3.10+ (uvx) is installed; 2. Run 'which npx' or 'which uvx' in terminal, and replace 'command' with absolute path; 3. Reload or restart the client window after modifying config.

Fix Snippet
# Check binary path in terminal:
which npx
node -v
Getting 'spawn npx ENOENT' or 'command not found'?

The editor background process does not inherit your full terminal PATH. Solution: Globally install the package, or set the absolute binary path (e.g. C:\Program Files\nodejs\npx.cmd on Windows, or /usr/local/bin/npx on macOS).

Missing required environment variable or authentication failure?

xbbg MCP requires environment variables (XBBG_MCP_LIB_DIR、XBBG_MCP_HOST、XBBG_MCP_PORT、XBBG_MCP_AUTH_METHOD、XBBG_MCP_MAX_ROWS、XBBG_MCP_MAX_CELLS、XBBG_MCP_MAX_METADATA_PROPERTIES、XBBG_MCP_MAX_METADATA_BYTES、XBBG_MCP_MAX_STRING_CHARS、XBBG_MCP_MAX_STRING_BYTES、XBBG_MCP_MAX_RESULT_BYTES). Ensure you have added valid keys under the 'env' object in your config file without trailing whitespace.

Fix Snippet
// .cursor/mcp.json 或 claude_desktop_config.json
{
  "env": {
    "API_KEY": "your_actual_key_here"
  }
}
Still not connecting? Read the MCP troubleshooting guide →

Tool Mock Playground

Sandbox

xbbg MCP Tool Interface Simulation · Preview tool schema & outputs without local runtime

Sandbox Ready
fn: xbbg_mcpExecute the core tool interface of xbbg MCP
Request ArgumentsJSON Schema
{
  "target": "xbbg MCP",
  "action": "execute",
  "options": {
    "mode": "standard",
    "timeoutMs": 5000
  }
}
💡Parameters generated dynamically by Agent runtime
Agent Tool Output

Click 'Run Mock' above

to preview the raw response returned to the LLM

Env: AgentHub Virtual SandboxJSON-RPC 2.0

Decision Guide: Why & When to Use

Assess suitability before installing to save trial-and-error time

Best Suited For
  • PR review
  • Changelog generation
  • Cross-repo issue search
When NOT to Use
  • Replacing human security audit
  • Unauthorized repo access
Recommended Workflow Pairing:View Scenario →

xbbg MCP + Scenario Prompt → Complete Agent Automation

MCP hands-on: install to visible results

Follow the full lab (expected UI/output + contrast checks). After installing this item, verify with the tutorial prompts.

Open tutorial →

Related resources

Often paired with

Keep exploring AgentHub

Most people compare similar tools or check scenario guides before installing—start here.

Browse more like thisSearch similarPick by scenarioPrompt playbooksMCP hands-onReviews & comparisons

Listing badge: put AgentHub on your site

Copy either snippet into your project homepage, docs, or GitHub README. The badge is a hotlinked SVG — nothing to host — and it links back to this page so visitors can find the install steps.

PreviewListed on AgentHub: xbbg MCP
HTML
<a href="https://myagenthub.cn/p/io.github.underloam/xbbg-mcp" title="Listed on AgentHub: xbbg MCP" target="_blank" rel="noopener">
  <img src="https://myagenthub.cn/badge/io.github.underloam/xbbg-mcp?lang=en" alt="Listed on AgentHub: xbbg MCP" height="20" style="border:0"/>
</a>
Markdown (GitHub README)
[![Listed on AgentHub: xbbg MCP](https://myagenthub.cn/badge/io.github.underloam/xbbg-mcp?lang=en)](https://myagenthub.cn/p/io.github.underloam/xbbg-mcp)

Badges are generated on the fly from /badge/<package-id>, so name and listing changes propagate automatically. Keep the link target unchanged — it is what counts as the referral.

Unified Manifest

{
  "id": "io.github.underloam/xbbg-mcp",
  "type": "mcp-server",
  "version": "1.5.0",
  "displayName": "xbbg MCP",
  "description": "Local Bloomberg tools for xbbg users.",
  "repository": {
    "url": "https://github.com/underloam/xbbg",
    "source": "github",
    "subfolder": "apps/xbbg-mcp"
  },
  "homepage": "https://github.com/underloam/xbbg/tree/main/apps/xbbg-mcp",
  "distribution": {
    "packages": [
      {
        "registryType": "mcpb",
        "identifier": "https://github.com/underloam/xbbg/releases/download/v1.5.0/xbbg-mcp-v1.5.0.mcpb",
        "version": "1.5.0",
        "transport": "stdio",
        "environmentVariables": [
          {
            "name": "XBBG_MCP_LIB_DIR",
            "description": "Optional directory containing Bloomberg runtime libraries. Leave unset to use BLPAPI_ROOT, an authorized vendored SDK layout, or Python blpapi fallback."
          },
          {
            "name": "XBBG_MCP_HOST",
            "description": "Bloomberg API host. Defaults to localhost."
          },
          {
            "name": "XBBG_MCP_PORT",
            "description": "Bloomberg API port. Defaults to 8194."
          },
          {
            "name": "XBBG_MCP_AUTH_METHOD",
            "description": "Bloomberg auth method: none, user, app, userapp, dir, manual, or token."
          },
          {
            "name": "XBBG_MCP_MAX_ROWS",
            "description": "Maximum rows returned to the MCP client per response. Defaults to 500."
          },
          {
            "name": "XBBG_MCP_MAX_CELLS",
            "description": "Maximum data cells across returned rows and columns. Defaults to 50000."
          },
          {
            "name": "XBBG_MCP_MAX_METADATA_PROPERTIES",
            "description": "Maximum metadata properties retained per response. Defaults to 50000."
          },
          {
            "name": "XBBG_MCP_MAX_METADATA_BYTES",
            "description": "Maximum metadata bytes parsed or returned per response. Defaults to 65536."
          },
          {
            "name": "XBBG_MCP_MAX_STRING_CHARS",
            "description": "Maximum characters per string value returned to the MCP client. Defaults to 2048."
          },
          {
            "name": "XBBG_MCP_MAX_STRING_BYTES",
            "description": "Maximum UTF-8 bytes per string value, including a truncation marker. Defaults to 8192; minimum 3."
          },
          {
            "name": "XBBG_MCP_MAX_RESULT_BYTES",
            "description": "Maximum compact-JSON bytes in the structured result, including diagnostics. Defaults to 1048576; minimum 2048."
          }
        ]
      }
    ],
    "remotes": []
  },
  "dependencies": [],
  "installTargets": [
    "claude-code",
    "claude-desktop",
    "cursor",
    "vscode",
    "trae",
    "cherry-studio",
    "lingma",
    "windsurf",
    "cline",
    "workbuddy"
  ],
  "keywords": [],
  "provenance": {
    "origin": "official-mcp-registry",
    "originalId": "io.github.underloam/xbbg-mcp",
    "originalUrl": "https://registry.modelcontextprotocol.io/v0.1/servers/io.github.underloam%2Fxbbg-mcp/versions/latest",
    "isOfficial": true,
    "status": "active"
  }
}