@esaio/esa-mcp-server 0.2.0 → 0.2.2

package/README.en.md

@@ -2,7 +2,7 @@
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-[日本語](README.md) | **English**
+[日本語](https://github.com/esaio/esa-mcp-server#readme) | **English**
 
 Official Model Context Protocol (MCP) server for esa.io - STDIO transport version.
 
@@ -13,6 +13,7 @@ This MCP server provides seamless integration between AI assistants and [esa.io]
 ## Available Tools
 
 ### Team Management
+
 - `esa_get_teams` - Get user's accessible esa teams
 - `esa_get_team_stats` - Get team statistics (members, posts, comments, stars, watches, active users)
 - `esa_get_team_tags` - Get all tags used in team posts with count
@@ -26,11 +27,13 @@ This MCP server provides seamless integration between AI assistants and [esa.io]
 - `esa_update_post` - Update existing post (title, content, tags, category, WIP status)
 
 ### Post Actions
+
 - `esa_archive_post` - Archive a post by moving to Archived/ category
 - `esa_ship_post` - Ship a post (mark as complete by setting wip to false)
 - `esa_duplicate_post` - Prepare a post for duplication (retrieve name and body_md)
 
 ### Comment Management
+
 - `esa_get_comment` - Get a specific comment by ID
 - `esa_create_comment` - Create a new comment on a post
 - `esa_update_comment` - Update an existing comment
@@ -39,6 +42,7 @@ This MCP server provides seamless integration between AI assistants and [esa.io]
 - `esa_get_team_comments` - Get team comments with pagination
 
 ### Category Management
+
 - `esa_get_categories` - Get categories and subcategories for a specific path
 - `esa_get_top_categories` - Get all top-level categories for a team
 - `esa_get_all_category_paths` - Get all category paths in a team (with post counts, supports filtering)
@@ -46,11 +50,13 @@ This MCP server provides seamless integration between AI assistants and [esa.io]
   - Filter examples: `prefix: "dev"` for development-related, `match: "api"` for API-related categories
 
 ### Attachments
+
 - `esa_get_attachment` - Retrieve an attachment file from esa posts and comments
   - Returns base64-encoded data for supported images (JPEG, PNG, GIF, WebP) under 30MB
   - Returns signed URLs (valid for 5 minutes) for other file types, larger images, or when forceSignedUrl is specified
 
 ### Help & Documentation
+
 - `esa_get_search_options_help` - Get esa search syntax documentation
 - `esa_get_markdown_syntax_help` - Get esa Markdown syntax documentation
 - `esa_search_help` - Search esa documentation for features and terminology
@@ -74,8 +80,8 @@ Add to your MCP client configuration file:
 ### Required Environment Variables
 
 - ESA_ACCESS_TOKEN: Access Token
-   - Required scopes: `read write` or `admin:comment read:post write:post read:category read:tag read:team read:member`
-   - [PAT v2](https://docs.esa.io/posts/559) is recommended.
+  - Required scopes: `read write` or `admin:comment read:post write:post read:category read:tag read:attachment read:team read:member`
+  - [PAT v2](https://docs.esa.io/posts/559) is recommended.
 - LANG: Language for UI
 
 ### Claude Desktop Example
@@ -115,9 +121,7 @@ Add to `claude_desktop_config.json`:
   "mcpServers": {
     "esa": {
       "command": "/Users/your-username/.nodenv/shims/npx",
-      "args": [
-        "@esaio/esa-mcp-server"
-      ],
+      "args": ["@esaio/esa-mcp-server"],
       "env": {
         "ESA_ACCESS_TOKEN": "your_personal_access_token",
         "LANG": "en"

package/README.md

@@ -2,9 +2,9 @@
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-**日本語** | [English](README.en.md)
+**日本語** | [English](https://github.com/esaio/esa-mcp-server/blob/main/README.en.md)
 
-esa.io の公式 MCP(Model Context Protocol)サーバー(STDIO Transport版)
+esa.io の公式 MCP(Model Context Protocol)サーバー(STDIO Transport 版)
 
 ## 概要
 
@@ -13,6 +13,7 @@ AI アシスタントと情報共有サービス [esa](https://esa.io) をつな
 ## 使えるツール
 
 ### チーム管理
+
 - `esa_get_teams` - 所属している esa チームの一覧
 - `esa_get_team_stats` - チームの統計情報（メンバー数、記事数、コメント数など）
 - `esa_get_team_tags` - チーム内で使われているタグと使用回数
@@ -21,16 +22,18 @@ AI アシスタントと情報共有サービス [esa](https://esa.io) をつな
 ### 記事管理
 
 - `esa_search_posts` - 記事を検索
-- `esa_get_post` - 記事IDから記事を取得
+- `esa_get_post` - 記事 ID から記事を取得
 - `esa_create_post` - 新しい記事を作成（タグ、カテゴリー、WIP ステータス付き）
 - `esa_update_post` - 記事を更新（タイトル、本文、タグ、カテゴリー、WIP ステータス）
 
 ### 記事の操作
+
 - `esa_archive_post` - 記事をアーカイブ（Archived/ カテゴリーへ移動）
 - `esa_ship_post` - 記事を Ship It!（WIP を外して公開）
 - `esa_duplicate_post` - 記事を複製するための準備（タイトルと本文を取得）
 
 ### コメント管理
+
 - `esa_get_comment` - コメント ID からコメントを取得
 - `esa_create_comment` - 記事にコメントを追加
 - `esa_update_comment` - コメントを編集
@@ -39,18 +42,21 @@ AI アシスタントと情報共有サービス [esa](https://esa.io) をつな
 - `esa_get_team_comments` - チーム全体のコメント一覧（ページング対応）
 
 ### カテゴリー管理
+
 - `esa_get_categories` - 指定パス配下のカテゴリー一覧
 - `esa_get_top_categories` - トップレベルのカテゴリー一覧
 - `esa_get_all_category_paths` - チーム内の全カテゴリーパス一覧（記事数付き、フィルタリング対応）
   - カテゴリ構造の把握、整理、統合の計画に最適
-  - フィルター例: `prefix: "dev"` で開発関連、`match: "api"` でAPI関連を検索
+  - フィルター例: `prefix: "dev"` で開発関連、`match: "api"` で API 関連を検索
 
 ### 添付ファイル
+
 - `esa_get_attachment` - 記事やコメントの添付ファイルを取得
-  - サポート形式（JPEG, PNG, GIF, WebP）で30MB以下の画像はbase64エンコードで返却
-  - その他のファイル、大きな画像、またはforceSignedUrl指定時は署名付きURL（有効期限5分）を返却
+  - サポート形式（JPEG, PNG, GIF, WebP）で 30MB 以下の画像は base64 エンコードで返却
+  - その他のファイル、大きな画像、または forceSignedUrl 指定時は署名付き URL（有効期限 5 分）を返却
 
 ### ヘルプとドキュメント
+
 - `esa_get_search_options_help` - esa の検索構文ヘルプ
 - `esa_get_markdown_syntax_help` - esa の Markdown 記法ヘルプ
 - `esa_search_help` - esa のドキュメントから機能や用語を検索
@@ -64,7 +70,7 @@ AI アシスタントと情報共有サービス [esa](https://esa.io) をつな
 ## プロンプト
 
 - `esa_summarize_post` - esa の記事を要約
-  - 入力: チーム名と記事ID
+  - 入力: チーム名と記事 ID
   - 出力: 記事の構造化された要約
 
 ## MCP クライアントの設定
@@ -74,8 +80,8 @@ MCP クライアントの設定ファイルに以下を追加します：
 ### 用意する環境変数
 
 - ESA_ACCESS_TOKEN: アクセストークン
-   - 必要なスコープ: `read write` または `admin:comment read:post write:post read:category read:tag read:team read:member`
-   - [PAT v2](https://docs.esa.io/posts/559)を推奨します。
+  - 必要なスコープ: `read write` または `admin:comment read:post write:post read:category read:tag read:attachment read:team read:member`
+  - [PAT v2](https://docs.esa.io/posts/559)を推奨します。
 - LANG: UI の言語設定
 
 ### Claude Desktop の例
@@ -115,9 +121,7 @@ MCP クライアントの設定ファイルに以下を追加します：
   "mcpServers": {
     "esa": {
       "command": "/Users/your-username/.nodenv/shims/npx",
-      "args": [
-        "@esaio/esa-mcp-server"
-      ],
+      "args": ["@esaio/esa-mcp-server"],
       "env": {
         "ESA_ACCESS_TOKEN": "your_personal_access_token",
         "LANG": "ja"

package/bin/{index.js → index.mjs}

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import{McpServer as e,ResourceTemplate as t}from"@modelcontextprotocol/sdk/server/mcp.js";import{StdioServerTransport as n}from"@modelcontextprotocol/sdk/server/stdio.js";import r from"i18next";import i from"openapi-fetch";import{z as a}from"zod";var o=`0.1.0`;const s={esa:{apiAccessToken:process.env.ESA_ACCESS_TOKEN||``,apiBaseUrl:process.env.ESA_API_BASE_URL||`https://api.esa.io`},server:{name:`esa-mcp-server`,version:o,description:`Official MCP server for esa.io`}};function c(){if(!s.esa.apiAccessToken)throw Error(`ESA_ACCESS_TOKEN environment variable is required`)}var l={prompts:{summarize_post:{title:`Summarize esa post`,description:`Summarize an esa post in various formats (bullet points, paragraph, or keywords)`,args:{team_name:`The name of the esa team`,post_number:`The post number to summarize`,format:`Summary format (bullet/paragraph/keywords)`}}}},ee={prompts:{summarize_post:{title:`esaの記事の要約`,description:`esa記事を指定した形式で要約します(bullet: 箇条書き, paragraph: 文章, keywords: キーワード)`,args:{team_name:`esaチーム名`,post_number:`要約する記事番号`,format:`要約形式 (bullet/paragraph/keywords)`}}}};async function te(){let e=process.env.LC_ALL?.split(/[-_.]/)[0]||process.env.LC_MESSAGES?.split(/[-_.]/)[0]||process.env.LANG?.split(/[-_.]/)[0]||process.env.LANGUAGE?.split(/[-_.]/)[0]||`en`;return await r.init({lng:e,fallbackLng:`en`,resources:{ja:{translation:ee},en:{translation:l}},interpolation:{escapeValue:!1}}),r}function u(e,t){return r.t(e,t)}function d(e){return{async onRequest({request:t}){return t.headers.set(`Authorization`,`Bearer ${e}`),t},async onResponse({response:e}){let t=e.headers.get(`x-ratelimit-limit`),n=e.headers.get(`x-ratelimit-remaining`);return t&&n&&console.error(`Rate limit: ${n}/${t}`),e},async onError({error:e}){console.error(`Network Error:`,e)}}}const ne=o;function re(e){return{async onRequest({request:t}){return t.headers.set(`User-Agent`,`esa-mcp-server/${e} (official)`),t}}}function ie(e,t=`https://api.esa.io`){let n=i({baseUrl:t});return n.use(re(ne)),n.use(d(e)),n}async function f(e,t,...n){let r;if(`apiAccessToken`in e&&`apiBaseUrl`in e)r=ie(e.apiAccessToken,e.apiBaseUrl);else throw Error(`Unsupported context type. Only StdioContext is currently supported.`);return t(r,...n)}var p=class extends Error{constructor(){super(`Missing required parameter 'teamName'. Use esa_get_teams to list available teams, then retry with teamName specified.`),this.name=`MissingTeamNameError`}};function m(e){return e instanceof Error?`Error: ${e.message}`:typeof e==`number`&&e!==null?`Error: API Response(status: ${e})`:typeof e==`object`&&e?`Error: ${JSON.stringify(e,null,2)}`:`Error: ${String(e)}`}function h(e){return{content:[{type:`text`,text:JSON.stringify(e,null,2)}]}}function g(e,t){return{contents:[{uri:t,mimeType:`application/json`,text:JSON.stringify(e,null,2)}]}}function _(e){return{messages:[{role:`user`,content:{type:`text`,text:e}}]}}function v(e){return{content:[{type:`text`,text:m(e)}]}}function y(e,t){return{contents:[{uri:t,mimeType:`application/json`,text:m(e)}]}}function b(e){return{messages:[{role:`user`,content:{type:`text`,text:m(e)}}]}}const ae=()=>a.object({teamName:a.string().describe(u(`prompts.summarize_post.args.team_name`)),postNumber:a.string().describe(u(`prompts.summarize_post.args.post_number`)),format:a.enum([`bullet`,`paragraph`,`keywords`]).optional().describe(u(`prompts.summarize_post.args.format`))});async function oe(e,t){let{teamName:n,postNumber:r,format:i=`bullet`}=t;if(!n)throw new p;let a=Number.parseInt(r,10);if(Number.isNaN(a)||a<=0)return b(`Post number must be a positive integer`);try{let{data:t,error:r,response:o}=await e.GET(`/v1/teams/{team_name}/posts/{post_number}`,{params:{path:{team_name:n,post_number:a}}});if(r||!o.ok)return b(r||o.status);let s=t,c=`Please summarize the following post:
+import{McpServer as e,ResourceTemplate as t}from"@modelcontextprotocol/sdk/server/mcp.js";import{StdioServerTransport as n}from"@modelcontextprotocol/sdk/server/stdio.js";import r from"i18next";import i from"openapi-fetch";import{z as a}from"zod";var o=`0.2.2`;const s={esa:{apiAccessToken:process.env.ESA_ACCESS_TOKEN||``,apiBaseUrl:process.env.ESA_API_BASE_URL||`https://api.esa.io`},server:{name:`esa-mcp-server`,version:o,description:`Official MCP server for esa.io`}};function c(){if(!s.esa.apiAccessToken)throw Error(`ESA_ACCESS_TOKEN environment variable is required`)}var l={prompts:{summarize_post:{title:`Summarize esa post`,description:`Summarize an esa post in various formats (bullet points, paragraph, or keywords)`,args:{team_name:`The name of the esa team`,post_number:`The post number to summarize`,format:`Summary format (bullet/paragraph/keywords)`}}}},ee={prompts:{summarize_post:{title:`esaの記事の要約`,description:`esa記事を指定した形式で要約します(bullet: 箇条書き, paragraph: 文章, keywords: キーワード)`,args:{team_name:`esaチーム名`,post_number:`要約する記事番号`,format:`要約形式 (bullet/paragraph/keywords)`}}}};async function te(){let e=process.env.LC_ALL?.split(/[-_.]/)[0]||process.env.LC_MESSAGES?.split(/[-_.]/)[0]||process.env.LANG?.split(/[-_.]/)[0]||process.env.LANGUAGE?.split(/[-_.]/)[0]||`en`;return await r.init({lng:e,fallbackLng:`en`,resources:{ja:{translation:ee},en:{translation:l}},interpolation:{escapeValue:!1}}),r}function u(e,t){return r.t(e,t)}function d(e){return{async onRequest({request:t}){return t.headers.set(`Authorization`,`Bearer ${e}`),t},async onResponse({response:e}){let t=e.headers.get(`x-ratelimit-limit`),n=e.headers.get(`x-ratelimit-remaining`);return t&&n&&console.error(`Rate limit: ${n}/${t}`),e},async onError({error:e}){console.error(`Network Error:`,e)}}}const ne=o;function re(e){return{async onRequest({request:t}){return t.headers.set(`User-Agent`,`esa-mcp-server/${e} (official)`),t}}}function ie(e,t=`https://api.esa.io`){let n=i({baseUrl:t});return n.use(re(ne)),n.use(d(e)),n}async function f(e,t,...n){let r;if(`apiAccessToken`in e&&`apiBaseUrl`in e)r=ie(e.apiAccessToken,e.apiBaseUrl);else throw Error(`Unsupported context type. Only StdioContext is currently supported.`);return t(r,...n)}var p=class extends Error{constructor(){super(`Missing required parameter 'teamName'. Use esa_get_teams to list available teams, then retry with teamName specified.`),this.name=`MissingTeamNameError`}};function m(e){return e instanceof Error?`Error: ${e.message}`:typeof e==`number`&&e!==null?`Error: API Response(status: ${e})`:typeof e==`object`&&e?`Error: ${JSON.stringify(e,null,2)}`:`Error: ${String(e)}`}function h(e){return{content:[{type:`text`,text:JSON.stringify(e,null,2)}]}}function g(e,t){return{contents:[{uri:t,mimeType:`application/json`,text:JSON.stringify(e,null,2)}]}}function _(e){return{messages:[{role:`user`,content:{type:`text`,text:e}}]}}function v(e){return{content:[{type:`text`,text:m(e)}]}}function y(e,t){return{contents:[{uri:t,mimeType:`application/json`,text:m(e)}]}}function b(e){return{messages:[{role:`user`,content:{type:`text`,text:m(e)}}]}}const ae=()=>a.object({teamName:a.string().describe(u(`prompts.summarize_post.args.team_name`)),postNumber:a.string().describe(u(`prompts.summarize_post.args.post_number`)),format:a.enum([`bullet`,`paragraph`,`keywords`]).optional().describe(u(`prompts.summarize_post.args.format`))});async function oe(e,t){let{teamName:n,postNumber:r,format:i=`bullet`}=t;if(!n)throw new p;let a=Number.parseInt(r,10);if(Number.isNaN(a)||a<=0)return b(`Post number must be a positive integer`);try{let{data:t,error:r,response:o}=await e.GET(`/v1/teams/{team_name}/posts/{post_number}`,{params:{path:{team_name:n,post_number:a}}});if(r||!o.ok)return b(r||o.status);let s=t,c=`Please summarize the following post:
 
 `;switch(c+=`Title: ${s.name}\n`,c+=`URL: ${s.url}\n`,c+=`Author: ${s.created_by.name}\n`,c+=`Created: ${s.created_at}\n`,c+=`Updated: ${s.updated_at}\n`,s.category&&(c+=`Category: ${s.category}\n`),s.tags&&s.tags.length>0&&(c+=`Tags: ${s.tags.join(`, `)}\n`),c+=`
 ---

package/package.json

@@ -1,12 +1,30 @@
 {
   "name": "@esaio/esa-mcp-server",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Official MCP server for esa.io - STDIO transport version",
   "main": "bin/index.js",
   "type": "module",
   "bin": {
     "esa-mcp-server": "./bin/index.js"
   },
+  "files": [
+    "bin",
+    "README.md",
+    "README.en.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/esaio/esa-mcp-server.git"
+  },
+  "bugs": {
+    "url": "https://github.com/esaio/esa-mcp-server/issues"
+  },
+  "homepage": "https://github.com/esaio/esa-mcp-server#readme",
   "scripts": {
     "build": "tsdown",
     "test": "vitest",
@@ -15,7 +33,8 @@
     "lint": "biome check . --error-on-warnings",
     "lint:fix": "biome check --write .",
     "type-check": "tsc --noEmit",
-    "update-esa-api": "openapi-typescript ../esa/api/openapi.yaml --output src/generated/api-types.ts && npm run lint:fix"
+    "update-esa-api": "openapi-typescript ../esa/api/openapi.yaml --output src/generated/api-types.ts && npm run lint:fix",
+    "prepublishOnly": "npm run build && npm run test:run && npm run lint && npm run type-check"
   },
   "keywords": [
     "mcp",
@@ -38,7 +57,7 @@
     "@types/node": "^20.19.15",
     "@vitest/coverage-v8": "^4.0.5",
     "openapi-typescript": "^7.9.1",
-    "tsdown": "^0.15.1",
+    "tsdown": "^0.16.0",
     "tsx": "^4.20.5",
     "typescript": "^5.9.2",
     "vitest": "^4.0.5"

package/.dockerignore

@@ -1,36 +0,0 @@
-.git
-.github
-
-.env
-.env.*
-.envrc
-
-.vscode
-.idea
-*.swp
-*.swo
-*~
-.DS_Store
-
-*.log
-npm-debug.log*
-
-tmp
-temp
-.tmp
-
-node_modules
-.node-version
-
-README.md
-LICENSE
-
-coverage
-
-.claude
-CLAUDE.md
-Dockerfile
-
-bin
-build
-dist

package/.github/dependabot.yml

@@ -1,23 +0,0 @@
-version: 2
-updates:
-- package-ecosystem: "github-actions"
-  directory: "/"
-  schedule:
-    interval: daily
-- package-ecosystem: npm
-  directory: "/"
-  schedule:
-    interval: daily
-    time: "03:00"
-    timezone: Asia/Tokyo
-  open-pull-requests-limit: 10
-  groups:
-    vitest:
-      patterns:
-        - "vitest"
-        - "@vitest/*"
-  ignore:
-    - dependency-name: "zod"
-      update-types: ["version-update:semver-major"]
-    - dependency-name: "@types/node"
-      update-types: ["version-update:semver-major"]

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

@@ -1,120 +0,0 @@
-name: Docker Build and Push
-
-on:
-  push:
-    tags: [ 'v*' ]
-
-env:
-  REGISTRY: ghcr.io
-  IMAGE_NAME: ${{ github.repository }}
-
-jobs:
-  build:
-    strategy:
-      fail-fast: true
-      matrix:
-        include:
-          - platform: linux/amd64
-            runner: ubuntu-latest
-          - platform: linux/arm64
-            runner: ubuntu-24.04-arm
-    runs-on: ${{ matrix.runner }}
-    permissions:
-      contents: read
-      packages: write
-
-    steps:
-    - name: Prepare
-      run: |
-        platform=${{ matrix.platform }}
-        echo "PLATFORM_PAIR=${platform//\//-}" >> $GITHUB_ENV
-
-    - name: Checkout repository
-      uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # https://github.com/actions/checkout/tree/v5
-
-    - name: Log in to Container Registry
-      uses: docker/login-action@5e57cd118135c172c3672efd75eb46360885c0ef # https://github.com/docker/login-action/tree/v3
-      with:
-        registry: ${{ env.REGISTRY }}
-        username: ${{ github.actor }}
-        password: ${{ secrets.GITHUB_TOKEN }}
-
-    - name: Extract metadata
-      id: meta
-      uses: docker/metadata-action@c1e51972afc2121e065aed6d45c65596fe445f3f # https://github.com/docker/metadata-action/tree/v5
-      with:
-        images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
-
-    - name: Set up Docker Buildx
-      uses: docker/setup-buildx-action@e468171a9de216ec08956ac3ada2f0791b6bd435 # https://github.com/docker/setup-buildx-action/tree/v3
-
-    - name: Build and push by digest
-      id: build
-      uses: docker/build-push-action@263435318d21b8e681c14492fe198d362a7d2c83 # https://github.com/docker/build-push-action/tree/v6
-      with:
-        context: .
-        platforms: ${{ matrix.platform }}
-        labels: ${{ steps.meta.outputs.labels }}
-        outputs: type=image,name=${{ env.REGISTRY }}/${{ env.IMAGE_NAME }},push-by-digest=true,name-canonical=true,push=true
-        cache-from: type=gha
-        cache-to: type=gha,mode=max
-
-    - name: Export digest
-      run: |
-        mkdir -p /tmp/digests
-        digest="${{ steps.build.outputs.digest }}"
-        touch "/tmp/digests/${digest#sha256:}"
-
-    - name: Upload digest
-      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # https://github.com/actions/upload-artifact/tree/v4
-      with:
-        name: digests-${{ env.PLATFORM_PAIR }}
-        path: /tmp/digests/*
-        if-no-files-found: error
-        retention-days: 1
-
-  merge:
-    runs-on: ubuntu-latest
-    needs:
-      - build
-    permissions:
-      contents: read
-      packages: write
-
-    steps:
-    - name: Download digests
-      uses: actions/download-artifact@018cc2cf5baa6db3ef3c5f8a56943fffe632ef53 # https://github.com/actions/download-artifact/tree/v5
-      with:
-        path: /tmp/digests
-        pattern: digests-*
-        merge-multiple: true
-
-    - name: Log in to Container Registry
-      uses: docker/login-action@5e57cd118135c172c3672efd75eb46360885c0ef # https://github.com/docker/login-action/tree/v3
-      with:
-        registry: ${{ env.REGISTRY }}
-        username: ${{ github.actor }}
-        password: ${{ secrets.GITHUB_TOKEN }}
-
-    - name: Set up Docker Buildx
-      uses: docker/setup-buildx-action@e468171a9de216ec08956ac3ada2f0791b6bd435 # https://github.com/docker/setup-buildx-action/tree/v3
-
-    - name: Extract metadata
-      id: meta
-      uses: docker/metadata-action@c1e51972afc2121e065aed6d45c65596fe445f3f # https://github.com/docker/metadata-action/tree/v5
-      with:
-        images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
-        tags: |
-          type=semver,pattern={{version}}
-          type=semver,pattern={{major}}.{{minor}}
-          type=semver,pattern={{major}}
-
-    - name: Create manifest list and push
-      working-directory: /tmp/digests
-      run: |
-        docker buildx imagetools create $(jq -cr '.tags | map("-t " + .) | join(" ")' <<< "$DOCKER_METADATA_OUTPUT_JSON") \
-          $(printf '${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}@sha256:%s ' *)
-
-    - name: Inspect image
-      run: |
-        docker buildx imagetools inspect ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}:${{ steps.meta.outputs.version }}

package/.github/workflows/main.yml

@@ -1,41 +0,0 @@
-name: CI
-on:
-  push:
-    branches:
-      - main
-  pull_request:
-    types: [opened, synchronize, reopened]
-
-env:
-  NODE_VERSION: 20.19.4
-
-jobs:
-  test:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # https://github.com/actions/checkout/tree/v5
-      - uses: actions/setup-node@2028fbc5c25fe9cf00d9f06a71cc4710d4507903 # https://github.com/actions/setup-node/tree/v5
-        with:
-          node-version: ${{ env.NODE_VERSION }}
-          cache: "npm"
-      - name: Install dependencies
-        run: npm ci
-      - name: Run linting
-        run: |
-          output=$(npm run lint 2>&1)
-          echo "$output"
-          if echo "$output" | grep -q "schema version does not match"; then
-            echo "::error::Biome schema version mismatch detected. Please run 'npx biome migrate --write' to update biome.json"
-            exit 1
-          fi
-      - name: Run type checking
-        run: npm run type-check
-      - name: Run tests
-        run: npm run test:coverage
-      - name: Upload coverage reports
-        uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # https://github.com/actions/upload-artifact/tree/v4
-        with:
-          name: coverage
-          path: coverage/
-      - name: Build
-        run: npm run build

package/CLAUDE.md

@@ -1,94 +0,0 @@
-# CLAUDE.md
-
-This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
-
-## Build and Development Commands
-
-```bash
-# Install dependencies
-npm install
-
-# Build the project
-npm run build
-
-# Run tests
-npm test              # Watch mode
-npm run test:run      # Single run
-npm run test:coverage # With coverage report
-
-# Linting
-npm run lint         # Check for linting issues
-npm run lint:fix     # Auto-fix linting and formatting issues
-
-# Type checking
-npm run type-check   # Check TypeScript types without building
-```
-
-## Architecture Overview
-
-This is an MCP (Model Context Protocol) server implementation for esa.io, using STDIO transport for communication. The architecture follows a simple structure:
-
-### Core Components
-
-1. **MCP Server Setup** (`src/index.ts`): Entry point that initializes the MCP server with STDIO transport. Handles transport lifecycle events and graceful error handling.
-
-2. **Configuration** (`src/config/index.ts`): Centralized configuration management that reads from environment variables. Required env vars:
-   - `ESA_ACCESS_TOKEN`: Required for esa.io API authentication
-   - `ESA_API_BASE_URL`: Optional API base URL (defaults to https://api.esa.io)
-
-### Key Technical Details
-
-- **Module System**: ES modules (type: "module" in package.json)
-- **TypeScript**: Strict mode enabled with comprehensive type checking
-- **Code Style**: Enforced by Biome (2 spaces, double quotes, semicolons, trailing commas)
-- **Node Version**: Requires Node.js >= 20.19.4
-
-### MCP Server Pattern
-
-The server follows the standard MCP pattern:
-1. Validate configuration on startup
-2. Create McpServer instance with name and version
-3. Initialize StdioServerTransport for STDIO communication
-4. Handle transport lifecycle (onclose, onerror)
-5. Connect server to transport
-
-When extending functionality, new tools and resources should be registered with the server instance before connecting to transport.
-
-## Testing Guidelines
-
-### Test Writing Principles
-
-When writing tests, follow these principles for maintainable and readable test code:
-
-1. **Import Order Optimization**
-   - Type imports first (`import type`)
-   - External dependencies next
-   - Internal modules last
-   - Group related imports together
-
-2. **Mock Creation Patterns**
-   - Use `as unknown as` pattern for type casting to keep mocks minimal and focused
-   - Create helper functions for complex mock objects (e.g., `createMockConfig`, `createMockServer`)
-   - Extract repetitive mock setup into shared helper functions (e.g., `setupServerMocks`)
-   - Return mock instances from helper functions for assertion access
-
-3. **Mock Documentation**
-   - Add concise comments explaining the purpose of each mock
-   - Focus on WHY the mock is needed, not WHAT it does
-   - Keep comments brief and directly above the mock definition
-
-4. **Module Mocking with vi.doMock**
-   - Use `vi.doMock` for replacing entire modules during import resolution
-   - Always call `vi.doMock` before the module import
-   - Use dynamic imports (`await import()`) after setting up module mocks
-   - Remember that `vi.doMock` is fundamentally different from `vi.fn()` - it intercepts module loading
-
-5. **Test Structure**
-   - Keep each test focused on a single behavior
-   - Use descriptive test names that explain the expected outcome
-   - Group related tests with `describe` blocks
-   - Clean up mocks in `beforeEach`/`afterEach` hooks
-
-### Example Test Pattern
-
-- READ src/__tests__/index.test.ts

package/Dockerfile

@@ -1,34 +0,0 @@
-# syntax=docker/dockerfile:1
-
-FROM node:alpine AS base
-
-WORKDIR /app
-
-FROM base AS deps
-
-RUN --mount=type=bind,source=package.json,target=package.json \
-    --mount=type=bind,source=package-lock.json,target=package-lock.json \
-    --mount=type=cache,target=/root/.npm \
-    npm ci --only=production
-
-FROM base AS build
-
-RUN --mount=type=bind,source=package.json,target=package.json \
-    --mount=type=bind,source=package-lock.json,target=package-lock.json \
-    --mount=type=cache,target=/root/.npm \
-    npm ci
-
-COPY . .
-
-RUN npm run build
-
-FROM base AS production
-
-ENV NODE_ENV=production
-
-USER node
-
-COPY --from=deps /app/node_modules ./node_modules
-COPY --from=build /app/bin ./bin
-
-ENTRYPOINT ["node", "bin/index.js"]

package/biome.json

@@ -1,57 +0,0 @@
-{
-  "$schema": "./node_modules/@biomejs/biome/configuration_schema.json",
-  "assist": {
-    "actions": {
-      "source": {
-        "organizeImports": "on"
-      }
-    }
-  },
-  "linter": {
-    "enabled": true,
-    "rules": {
-      "recommended": true,
-      "complexity": {
-        "noForEach": "off"
-      },
-      "suspicious": {
-        "noExplicitAny": "error",
-        "noConsole": "off"
-      },
-      "style": {
-        "useFilenamingConvention": {
-          "level": "error",
-          "options": {
-            "filenameCases": ["kebab-case"]
-          }
-        }
-      }
-    }
-  },
-  "formatter": {
-    "enabled": true,
-    "formatWithErrors": false,
-    "indentStyle": "space",
-    "indentWidth": 2,
-    "lineWidth": 80,
-    "lineEnding": "lf"
-  },
-  "javascript": {
-    "formatter": {
-      "quoteStyle": "double",
-      "semicolons": "always",
-      "trailingCommas": "all"
-    }
-  },
-  "files": {
-    "includes": [
-      "**",
-      "!**/node_modules",
-      "!**/bin",
-      "!**/coverage",
-      "!**/*.config.js",
-      "!**/*.config.ts",
-      "!.claude"
-    ]
-  }
-}