@moonbanking/mcp-server 0.5.6

package/.github/workflows/npm-publish.yml

@@ -0,0 +1,137 @@
+name: Publish to npm
+
+on:
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+    inputs:
+      dry_run:
+        description: 'Run in dry-run mode (test without publishing)'
+        required: false
+        type: boolean
+        default: false
+
+jobs:
+  publish:
+    name: Build and Publish to npm
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write # Required for npm provenance
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Get package version
+        id: package_version
+        run: |
+          VERSION=$(node -p "require('./package.json').version")
+          echo "version=$VERSION" >> $GITHUB_OUTPUT
+          echo "📦 Package version: $VERSION"
+
+      - name: Check if version already published
+        id: check_version
+        run: |
+          PACKAGE_NAME=$(node -p "require('./package.json').name")
+          if npm view "$PACKAGE_NAME@${{ steps.package_version.outputs.version }}" version 2>/dev/null; then
+            echo "exists=true" >> $GITHUB_OUTPUT
+            echo "⚠️  Version ${{ steps.package_version.outputs.version }} already published"
+          else
+            echo "exists=false" >> $GITHUB_OUTPUT
+            echo "✅ Version ${{ steps.package_version.outputs.version }} not yet published"
+          fi
+
+      - name: Install dependencies
+        if: steps.check_version.outputs.exists == 'false'
+        run: npm install
+
+      - name: Build package
+        if: steps.check_version.outputs.exists == 'false'
+        run: npm run build
+
+      - name: Verify build output
+        if: steps.check_version.outputs.exists == 'false'
+        run: |
+          echo "📁 Checking dist/ directory:"
+          ls -la dist/
+          echo ""
+          echo "📄 Main file exists:"
+          test -f dist/index.js && echo "✅ dist/index.js found" || echo "❌ dist/index.js missing"
+          test -f dist/index.d.ts && echo "✅ dist/index.d.ts found" || echo "❌ dist/index.d.ts missing"
+
+      - name: Publish to npm (dry-run)
+        if: |
+          steps.check_version.outputs.exists == 'false' &&
+          github.event_name == 'workflow_dispatch' &&
+          github.event.inputs.dry_run == 'true'
+        run: |
+          echo "🧪 Running in dry-run mode"
+          npm publish --dry-run --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+      - name: Publish to npm
+        if: |
+          steps.check_version.outputs.exists == 'false' &&
+          (github.event_name == 'push' || github.event.inputs.dry_run == 'false')
+        run: npm publish --provenance --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+      - name: Create GitHub Release
+        if: |
+          steps.check_version.outputs.exists == 'false' &&
+          (github.event_name == 'push' || github.event.inputs.dry_run == 'false')
+        uses: actions/create-release@v1
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          tag_name: v${{ steps.package_version.outputs.version }}
+          release_name: v${{ steps.package_version.outputs.version }}
+          body: |
+            ## @moonbanking/mcp-server v${{ steps.package_version.outputs.version }}
+
+            Published to npm: https://www.npmjs.com/package/@moonbanking/mcp-server/v/${{ steps.package_version.outputs.version }}
+
+            ### Installation
+            ```bash
+            npm install @moonbanking/mcp-server@${{ steps.package_version.outputs.version }}
+            ```
+
+            ### Usage
+            ```bash
+            npx @moonbanking/mcp
+            ```
+          draft: false
+          prerelease: ${{ contains(steps.package_version.outputs.version, '-') }}
+
+      - name: Summary
+        if: steps.check_version.outputs.exists == 'false'
+        run: |
+          echo "## 🎉 Published Successfully!" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "**Package:** @moonbanking/mcp-server" >> $GITHUB_STEP_SUMMARY
+          echo "**Version:** ${{ steps.package_version.outputs.version }}" >> $GITHUB_STEP_SUMMARY
+          echo "**npm URL:** https://www.npmjs.com/package/@moonbanking/mcp-server" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "### Install" >> $GITHUB_STEP_SUMMARY
+          echo '```bash' >> $GITHUB_STEP_SUMMARY
+          echo "npm install @moonbanking/mcp-server@${{ steps.package_version.outputs.version }}" >> $GITHUB_STEP_SUMMARY
+          echo '```' >> $GITHUB_STEP_SUMMARY
+
+      - name: Skip publishing (already exists)
+        if: steps.check_version.outputs.exists == 'true'
+        run: |
+          echo "## ℹ️ Version Already Published" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "Version ${{ steps.package_version.outputs.version }} is already published to npm." >> $GITHUB_STEP_SUMMARY
+          echo "Skipping publish step." >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "**npm URL:** https://www.npmjs.com/package/@moonbanking/mcp-server" >> $GITHUB_STEP_SUMMARY

package/README.md

@@ -0,0 +1,77 @@
+# @moonbanking/mcp-server
+
+# Welcome to the Moon Banking API!
+
+Enjoy the documentation and happy coding. Share this spec with your LLM of choice to speed up your development, or take a look at our MCP server and various SDKs.
+
+### More information
+
+For more information about the Moon Banking API, please visit the [Moon Banking Documentation](https://docs.moonbanking.com).
+
+This MCP server provides tools to interact with the Moon Banking API API based on OpenAPI specification version 2025-07-11.
+
+## Installation
+
+```bash
+npm install @moonbanking/mcp-server
+```
+
+Or use with npx:
+
+```bash
+npx @moonbanking/mcp-server
+```
+
+## Configuration
+
+### Required Environment Variables
+
+- `MOON_BANKING_API_KEY`: Your API key for authentication
+
+### Optional Environment Variables
+
+- `MOON_BANKING_INTERNAL_BASE_URL`: Custom base URL (defaults to https://api.moonbanking.com/v1)
+
+## Usage
+
+### With MCP Client
+
+Add to your MCP client configuration:
+
+```json
+{
+  "mcpServers": {
+    "mcp-server": {
+      "command": "npx",
+      "args": ["-y", "@moonbanking/mcp-server"],
+      "env": {
+        "MOON_BANKING_API_KEY": "your-api-key-here",
+        "MOON_BANKING_INTERNAL_BASE_URL": "https://api.moonbanking.com/v1"
+      }
+    }
+  }
+}
+```
+
+### Filter Specific Tools
+
+You can limit which tools are exposed by using the `--tool` flag:
+
+```bash
+npx @moonbanking/mcp-server --tool=tool1 --tool=tool2
+```
+
+## Available Tools
+
+- `bank-get`: This endpoint allows you to retrieve a paginated list of all banks. By default, a maximum of ten banks are shown per page. You can search banks by name, filter by country and description (including null/not_null status or semantic content search using vector embeddings), sort them by various fields, and include related data like scores and country information. When searching description content, results are ordered by semantic similarity.
+- `bank-getById`: This endpoint allows you to retrieve a specific bank by providing the bank ID. You can include related data like scores and country information in the response.
+- `bankVote-get`: This endpoint allows you to retrieve a paginated list of bank votes. You can filter by bank ID, category, country, vote type (upvote or downvote), and other parameters.
+- `country-get`: This endpoint allows you to retrieve a paginated list of all countries. By default, a maximum of ten countries are shown per page. You can search countries by name or 2-letter code, sort them by various fields, and include related data like scores.
+- `country-getByCountryCode`: This endpoint allows you to retrieve a specific country by providing the 2-letter ISO country code. You can include related data like scores in the response.
+- `story-get`: This endpoint allows you to retrieve a paginated list of all stories. By default, a maximum of ten stories are shown per page. You can search stories by text content, filter by bank ID, sort them by various fields, and include related data like bank and country information.
+- `story-getById`: This endpoint allows you to retrieve a specific story by providing the story ID. You can include related data like bank and country information in the response.
+- `world-getOverview`: This endpoint allows you to retrieve global overview data that aggregates banks votes, stories and other data across all banks in all countries. You can include related data like scores in the response.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}