init

Author: EliFuzz

.eslintrc.json

@@ -0,0 +1,37 @@
+{
+  "env": {
+    "es6": true,
+    "node": true
+  },
+  "extends": [
+    "eslint:recommended",
+    "plugin:@typescript-eslint/eslint-recommended",
+    "plugin:@typescript-eslint/recommended",
+    "plugin:prettier/recommended"
+  ],
+  "globals": {
+    "Atomics": "readonly",
+    "SharedArrayBuffer": "readonly"
+  },
+  "parser": "@typescript-eslint/parser",
+  "parserOptions": {
+    "ecmaVersion": 2018,
+    "sourceType": "module"
+  },
+  "plugins": ["@typescript-eslint"],
+  "rules": {
+    "indent": ["error", 2],
+    "linebreak-style": ["error", "unix"],
+    "quotes": ["error", "single"],
+    "semi": ["error", "always"],
+    "@typescript-eslint/explicit-function-return-type": "off",
+    "@typescript-eslint/no-explicit-any": "error",
+    "@typescript-eslint/no-unused-vars": [
+      "warn",
+      {
+        "argsIgnorePattern": "^_"
+      }
+    ],
+    "no-console": "warn"
+  }
+}

.github/workflows/publish.yml

@@ -0,0 +1,49 @@
+name: Publish to NPM
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "24"
+          registry-url: "https://registry.npmjs.org"
+
+      - name: Install pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 8
+
+      - name: Get pnpm store directory
+        id: pnpm-cache
+        shell: bash
+        run: |
+          echo "STORE_PATH=$(pnpm store path)" >> $GITHUB_OUTPUT
+
+      - name: Setup pnpm cache
+        uses: actions/cache@v4
+        with:
+          path: ${{ steps.pnpm-cache.outputs.STORE_PATH }}
+          key: ${{ runner.os }}-pnpm-store-${{ hashFiles('**/pnpm-lock.yaml') }}
+          restore-keys: |
+            ${{ runner.os }}-pnpm-store-
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Build
+        run: pnpm run build
+
+      - name: Publish to NPM
+        run: pnpm publish --no-git-checks --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

.gitignore

@@ -0,0 +1,13 @@
+# OS
+.DS_Store
+Thumbs.db
+
+# IDE
+.vscode/
+.idea/
+
+# Node.js
+node_modules/
+dist/
+build/
+.env

.mcp/server.json

@@ -0,0 +1,11 @@
+{
+  "mcpServers": {
+    "api-docs-mcp": {
+      "command": "npx",
+      "args": ["api-docs-mcp"],
+      "env": {
+        "MCP_API_SOURCES": "[{\"name\":\"GitHub\",\"type\":\"gql\",\"url\":\"https://docs.github.com/public/fpt/schema.docs.graphql\"}]"
+      }
+    }
+  }
+}

.npmignore

@@ -0,0 +1,30 @@
+# Source files
+src/
+*.ts
+!*.d.ts
+
+# Configuration files
+tsconfig.json
+eslint.config.mjs
+.eslintrc.json
+
+# Development files
+.vscode/
+.github/
+node_modules/
+.DS_Store
+
+# Lock files
+pnpm-lock.yaml
+
+# Test files
+test/
+tests/
+*.test.js
+*.spec.js
+
+# Documentation
+README.md
+
+# Schema (if not needed for runtime)
+schema.json

README.md

@@ -1,2 +1,3 @@
-# api-map
-API MCP
+# API Docs MCP
+
+MCP server for API and GraphQL documentation and search.

package.json

@@ -0,0 +1,57 @@
+{
+  "name": "api-docs-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for API and GraphQL documentation and search",
+  "type": "module",
+  "main": "build/index.js",
+  "types": "build/index.d.ts",
+  "bin": {
+    "api-docs-mcp": "build/index.js"
+  },
+  "files": [
+    "build",
+    "LICENSE",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc && tsc-alias",
+    "start": "node build/index.js",
+    "dev": "tsc --watch"
+  },
+  "keywords": [
+    "mcp",
+    "graphql",
+    "api-docs"
+  ],
+  "author": "",
+  "license": "Apache-2.0",
+  "dependencies": {
+    "@graphql-tools/graphql-file-loader": "8.1.2",
+    "@graphql-tools/load": "8.1.2",
+    "@graphql-tools/url-loader": "9.0.0",
+    "@graphql-tools/utils": "10.9.1",
+    "@modelcontextprotocol/sdk": "1.20.1",
+    "graphql": "16.11.0",
+    "module-alias": "^2.2.3",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@modelcontextprotocol/inspector": "0.17.2",
+    "@types/node": "^24.9.1",
+    "@typescript-eslint/eslint-plugin": "^8.46.2",
+    "@typescript-eslint/parser": "^8.46.2",
+    "concurrently": "9.2.1",
+    "cross-env": "10.1.0",
+    "eslint": "^9.38.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.4",
+    "tsc-alias": "^1.8.16",
+    "typescript": "5.9.3"
+  }
+}