digital-science/dimensions-analytics-mcp

Build the monorepo (pnpm run build) and start the local stdio MCP server (apps/mcp/bin/dimensions-analytics-mcp.js), then call MCP initialize and tools/list; 27 tools returned (search_publications, execute_dsl, describe_schema, ...).

cd <host-path> && ls -la && cat README.md | head -200
cd <host-path> && git log -1 --format=%H 2>/dev/null; cat pyproject.toml 2>/dev/null | head -60; ls .github/workflows 2>/dev/null; which python3 pip uv node npm; python3 --version
cd <host-path> && cat package.json && cat justfile && sed -n 1,200p docs/INSTALLATION.md | head -150 && cat .env.example && cat server.json | head -40; ls apps apps/*; which node npm pnpm npx
cd <host-path> && grep -n -i -A6 "build\|mcp\b\|stdio\|node " apps/mcp/README.md | head -120; ls <host-path> 2>/dev/null; cat .github/workflows/ci.yml | head -60
cd /tmp && export NODE_USE_ENV_PROXY=1 && (curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - && sudo apt-get install -y nodejs) 2>&1 | tail -5; node -v; npm -v
cd <host-path> && export NODE_USE_ENV_PROXY=1 && sudo npm install -g [email protected] 2>&1 | tail -2 && pnpm -v && pnpm install --frozen-lockfile 2>&1 | tail -15
cd <host-path> && export NODE_USE_ENV_PROXY=1 && pnpm install --frozen-lockfile --ignore-scripts 2>&1 | tail -3 && pnpm run build 2>&1 | tail -10 && ls apps/mcp/dist | head && cat apps/mcp/package.json | head -40
cd /tmp && export NODE_USE_ENV_PROXY=1 && ( printf '%s\n' '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"probe","version":"0"}}}' '{"jsonrpc":"2.0","method":"notifications/initialized"}' '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'; sleep 3 ) | timeout 20 node <host-path> 2>/tmp/mcp_err.txt | cut -c1-600; echo "rc=$?"; echo ---; head -c 1500 /tmp/mcp_err.txt
cd /tmp && export NODE_USE_ENV_PROXY=1 && ( printf '%s\n' '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"probe","version":"0"}}}' '{"jsonrpc":"2.0","method":"notifications/initialized"}' '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'; sleep 4 ) | DIMENSIONS_API_KEY=placeholder-local-test DIMENSIONS_MCP_UPDATE_CHECK=0 timeout 25 node <host-path> 2>/tmp/mcp_err.txt | python3 -c "
import sys,json
for l in sys.stdin:
    try: m=json.loads(l)
    except: print('RAW',l[:300]); continue
    if m.get('id')==2: print('tools:',[t['name'] for t in m['result']['tools']])
    elif m.get('id')==1: print('init ok:',m['result']['serverInfo'])
"; echo "stderr:"; head -c 800 /tmp/mcp_err.txt
cd <host-path> && NODE=$(command -v node) && echo $NODE && ls -la .coldpass 2>/dev/null; mkdir -p .coldpass && cat > .coldpass/probe.json <<EOF
{"kind":"mcp","argv":["$NODE","<host-path>","env":{"DIMENSIONS_API_KEY":"placeholder-local-test","DIMENSIONS_MCP_UPDATE_CHECK":"0"}}
EOF
cat > .coldpass/report.json <<'EOF'
{"outcome":"working","operation":"Build the monorepo (pnpm run build) and start the local stdio MCP server (apps/mcp/bin/dimensions-analytics-mcp.js), then call MCP initialize and tools/list; 27 tools returned (search_publications, execute_dsl, describe_schema, ...).","operation_scope":"Startup and tool discovery only. Real Dimensions API calls (searches, DSL queries) were not exercised because no Dimensions API key is available in the guest; the server was started with a placeholder DIMENSIONS_API_KEY, which it accepts at startup.","steps":["Read README.md, docs/INSTALLATION.md, apps/mcp/README.md, package.json, justfile, .github/workflows/ci.yml","Installed Node.js 22 (NodeSource setup_22.x, apt nodejs) -> v22.23.3","sudo npm install -g [email protected] -> 9.15.9","pnpm install --frozen-lockfile --ignore-scripts","pnpm run build (tsc in apps/mcp, produces apps/mcp/dist)","node apps/mcp/bin/dimensions-analytics-mcp.js with DIMENSIONS_API_KEY set: initialize + tools/list over stdio"],"deviations":["pnpm install --frozen-lockfile failed in the prepare script (lefthook install: 'not a git repository'); reran with --ignore-scripts. Lefthook git hooks are not installed, which is harmless here.","Server refuses to start without DIMENSIONS_API_KEY ('Failed to start MCP server: Dimensions API key required'); used placeholder value 'placeholder-local-test' for startup/tools listing only. Did not search for or create real credentials."],"stuck_step":null,"main_blocker":null,"suggested_fix":null}
EOF
<env-var>=<host-path> python3 -I <host-path> --validate 2>&1 | tail -20
pgrep -af dimensions-analytics-mcp || echo "no leftover server processes"; cat <host-path>