chore: import upstream snapshot with attribution

2026-07-13 12:45:31 +08:00
commit 588cfc5bb3
102 changed files with 17373 additions and 0 deletions
@@ -0,0 +1,3 @@
+# These are supported funding model platforms
+
+github: GLips
@@ -0,0 +1,88 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ""
+labels: bug
+assignees: ""
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**Software Versions**
+
+- Figma Developer MCP: Run the MCP with `--version`—either npx or locally, depending on how you're running it.
+- Node.js: `node --version`
+- NPM: `npm --version`
+- Operating System:
+- Client: e.g. Cursor, VSCode, Claude Desktop, etc.
+- Client Version:
+
+**To Reproduce**
+Steps to reproduce the behavior:
+
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem. Often a screenshot of your entire chat window where you're trying to trigger the MCP is helpful.
+
+**Server Configuration**
+Provide your MCP JSON configuration, if applicable. E.g.
+
+```
+    "figma-developer-mcp": {
+      "command": "npx",
+      "args": [
+        "figma-developer-mcp",
+        "--figma-api-key=REDACTED",
+        "--stdio"
+      ]
+    }
+```
+
+**Command Line Logs**
+If you're running the MCP locally on the command line, include all the logs for those like so:
+
+```
+> npx figma-developer-mcp --figma-api-key=REDACTED
+
+Configuration:
+- FIGMA_API_KEY: ****8pXg (source: cli)
+- PORT: 3333 (source: default)
+
+Initializing Figma MCP Server in HTTP mode on 127.0.0.1:3333...
+HTTP server listening on port 3333
+StreamableHTTP endpoint available at http://127.0.0.1:3333/mcp
+StreamableHTTP endpoint available at http://127.0.0.1:3333/sse (backward compat)
+```
+
+**MCP Logs**
+If you're running the MCP in a code editor like Cursor, there are MCP-specific logs that provide more context on any errors. In Cursor, you can find them by clicking `CMD + Shift + P` and looking for `Developer: Show Logs...`. Within the show logs window, you can find `Cursor MCP`—copy and paste the contents there into the bug report.
+
+```
+2025-03-18 11:36:22.251 [info] pnpx: Handling CreateClient action
+2025-03-18 11:36:22.251 [info] pnpx: getOrCreateClient for stdio server.  process.platform: darwin isElectron: true
+2025-03-18 11:36:22.251 [info] pnpx: Starting new stdio process with command: pnpx figma-developer-mcp --figma-api-key=REDACTED --stdio
+2025-03-18 11:36:23.987 [info] pnpx: Successfully connected to stdio server
+2025-03-18 11:36:23.987 [info] pnpx: Storing stdio client
+2025-03-18 11:36:23.988 [info]  MCP: Handling ListOfferings action
+2025-03-18 11:36:23.988 [error]  MCP: No server info found
+2025-03-18 11:36:23.988 [info] pnpx: Handling ListOfferings action
+2025-03-18 11:36:23.988 [info] pnpx: Listing offerings
+2025-03-18 11:36:23.988 [info] pnpx: getOrCreateClient for stdio server.  process.platform: darwin isElectron: true
+2025-03-18 11:36:23.988 [info] pnpx: Reusing existing stdio client
+2025-03-18 11:36:23.988 [info] pnpx: Connected to stdio server, fetching offerings
+2025-03-18 11:36:24.005 [info] listOfferings: Found 2 tools
+2025-03-18 11:36:24.005 [info] pnpx: Found 2 tools, 0 resources, and 0 resource templates
+2025-03-18 11:36:24.005 [info]  npx: Handling ListOfferings action
+2025-03-18 11:36:24.005 [error]  npx: No server info found
+```
+
+**Additional context**
+Add any other context about the problem here.
@@ -0,0 +1,19 @@
+name: "Setup and install"
+description: "Common setup steps for Actions"
+
+runs:
+  using: composite
+  steps:
+    - name: Install pnpm
+      uses: pnpm/action-setup@v4
+      with:
+        version: 10.10.0
+    - name: Install Node.js v20
+      uses: actions/setup-node@v4
+      with:
+        node-version: 20.17.0
+        cache: "pnpm"
+
+    - name: Install PNPM Dependencies
+      shell: bash
+      run: pnpm install
@@ -0,0 +1,29 @@
+name: CI
+
+on:
+  pull_request:
+    branches:
+      - main
+
+jobs:
+  ci:
+    name: Lint, Type Check, Test
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ./.github/actions/setup
+
+      - name: Scan for hidden characters
+        run: node scripts/scan-hidden-chars.mjs
+
+      - name: Check formatting
+        run: pnpm prettier --check "src/**/*.ts"
+
+      - name: Lint
+        run: pnpm lint
+
+      - name: Type check
+        run: pnpm type-check
+
+      - name: Test
+        run: pnpm test
@@ -0,0 +1,70 @@
+name: Release
+
+on:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: write
+  pull-requests: write
+  id-token: write # Required for npm OIDC trusted publishing
+
+jobs:
+  release-please:
+    if: ${{ github.repository_owner == 'GLips' }}
+    runs-on: ubuntu-latest
+    env:
+      FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+    steps:
+      - uses: googleapis/release-please-action@v4
+        id: release
+
+      - uses: actions/checkout@v4
+        if: ${{ steps.release.outputs.release_created }}
+
+      - uses: pnpm/action-setup@v4
+        with:
+          version: 10.10.0
+        if: ${{ steps.release.outputs.release_created }}
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 24
+          registry-url: "https://registry.npmjs.org"
+        if: ${{ steps.release.outputs.release_created }}
+
+      - name: Install dependencies
+        run: pnpm install
+        if: ${{ steps.release.outputs.release_created }}
+
+      - name: Type check
+        run: pnpm type-check
+        if: ${{ steps.release.outputs.release_created }}
+
+      - name: Build
+        run: pnpm build
+        if: ${{ steps.release.outputs.release_created }}
+
+      - name: Publish to npm
+        run: pnpm publish --no-git-checks
+        env:
+          NODE_ENV: production
+        if: ${{ steps.release.outputs.release_created }}
+
+      - name: Update server.json version
+        run: |
+          VERSION="${{ steps.release.outputs.major }}.${{ steps.release.outputs.minor }}.${{ steps.release.outputs.patch }}"
+          jq --arg v "$VERSION" '.version = $v | .packages[0].version = $v' server.json > server.tmp && mv server.tmp server.json
+        if: ${{ steps.release.outputs.release_created }}
+
+      - name: Install mcp-publisher
+        run: |
+          curl -L "https://github.com/modelcontextprotocol/registry/releases/latest/download/mcp-publisher_linux_amd64.tar.gz" | tar xz mcp-publisher
+        if: ${{ steps.release.outputs.release_created }}
+
+      - name: Publish to MCP Registry
+        run: |
+          ./mcp-publisher login github-oidc
+          ./mcp-publisher publish
+        if: ${{ steps.release.outputs.release_created }}