excel-mcp-server-pcvelz 0.15.0

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 Kazuki Negoro
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/README.md

@@ -0,0 +1,218 @@
+# Excel MCP Server
+
+<img src="https://github.com/negokaz/excel-mcp-server/blob/main/docs/img/icon-800.png?raw=true" width="128">
+
+<a href="https://glama.ai/mcp/servers/@negokaz/excel-mcp-server">
+  <img width="380" height="200" src="https://glama.ai/mcp/servers/@negokaz/excel-mcp-server/badge" alt="Excel Server MCP server" />
+</a>
+
+[![NPM Version](https://img.shields.io/npm/v/@negokaz/excel-mcp-server)](https://www.npmjs.com/package/@negokaz/excel-mcp-server)
+[![smithery badge](https://smithery.ai/badge/@negokaz/excel-mcp-server)](https://smithery.ai/server/@negokaz/excel-mcp-server)
+
+A Model Context Protocol (MCP) server that reads and writes MS Excel data.
+
+## Why Fork?
+
+This fork ([pcvelz/excel-mcp-server](https://github.com/pcvelz/excel-mcp-server)) adds features needed for real-world bookkeeping workflows that are not yet available upstream:
+
+- **Alignment support in `excel_format_range`** — set horizontal/vertical alignment (e.g., left-align numbers)
+- **Alignment in `showStyle` output** — read back cell alignment when using `showStyle: true`
+- **Cell type attributes** — `type` attribute (string, number, formula, date) in `showStyle` output
+- **Raw value attributes** — `raw` attribute showing unformatted values alongside displayed values
+- **ISO date auto-conversion** — write ISO date strings (e.g., `"2026-02-03"`) and they're automatically converted to Excel date serial numbers
+
+See the [upstream comparison](https://github.com/negokaz/excel-mcp-server/compare/main...pcvelz:excel-mcp-server:main) for full diff.
+
+## Features
+
+- Read/Write text values
+- Read/Write formulas
+- Create new sheets
+
+**🪟Windows only:**
+- Live editing
+- Capture screen image from a sheet
+
+For more details, see the [tools](#tools) section.
+
+## Requirements
+
+- Node.js 20.x or later
+
+## Supported file formats
+
+- xlsx (Excel book)
+- xlsm (Excel macro-enabled book)
+- xltx (Excel template)
+- xltm (Excel macro-enabled template)
+
+## Installation
+
+### Installing via NPM
+
+excel-mcp-server is automatically installed by adding the following configuration to the MCP servers configuration.
+
+For Windows:
+```json
+{
+    "mcpServers": {
+        "excel": {
+            "command": "cmd",
+            "args": ["/c", "npx", "--yes", "@negokaz/excel-mcp-server"],
+            "env": {
+                "EXCEL_MCP_PAGING_CELLS_LIMIT": "4000"
+            }
+        }
+    }
+}
+```
+
+For other platforms:
+```json
+{
+    "mcpServers": {
+        "excel": {
+            "command": "npx",
+            "args": ["--yes", "@negokaz/excel-mcp-server"],
+            "env": {
+                "EXCEL_MCP_PAGING_CELLS_LIMIT": "4000"
+            }
+        }
+    }
+}
+```
+
+### Installing via Smithery
+
+To install Excel MCP Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@negokaz/excel-mcp-server):
+
+```bash
+npx -y @smithery/cli install @negokaz/excel-mcp-server --client claude
+```
+
+<h2 id="tools">Tools</h2>
+
+### `excel_describe_sheets`
+
+List all sheet information of specified Excel file.
+
+**Arguments:**
+- `fileAbsolutePath`
+    - Absolute path to the Excel file
+
+### `excel_read_sheet`
+
+Read values from Excel sheet with pagination.
+
+**Arguments:**
+- `fileAbsolutePath`
+    - Absolute path to the Excel file
+- `sheetName`
+    - Sheet name in the Excel file
+- `range`
+    - Range of cells to read in the Excel sheet (e.g., "A1:C10"). [default: first paging range]
+- `showFormula`
+    - Show formula instead of value [default: false]
+- `showStyle`
+    - Show style information for cells [default: false]
+    - When enabled, output includes:
+        - `style-ref`: References to style definitions (border, font, fill, alignment, numFmt)
+        - `type`: Cell type (number, string, date, bool, formula, error)
+        - `raw`: Raw/unformatted value (shown when different from displayed value, e.g., `raw="45691"` for a date displayed as "3-Feb")
+
+### `excel_screen_capture`
+
+**[Windows only]** Take a screenshot of the Excel sheet with pagination.
+
+**Arguments:**
+- `fileAbsolutePath`
+    - Absolute path to the Excel file
+- `sheetName`
+    - Sheet name in the Excel file
+- `range`
+    - Range of cells to read in the Excel sheet (e.g., "A1:C10"). [default: first paging range]
+
+### `excel_write_to_sheet`
+
+Write values to the Excel sheet.
+
+**Arguments:**
+- `fileAbsolutePath`
+    - Absolute path to the Excel file
+- `sheetName`
+    - Sheet name in the Excel file
+- `newSheet`
+    - Create a new sheet if true, otherwise write to the existing sheet
+- `range`
+    - Range of cells to read in the Excel sheet (e.g., "A1:C10").
+- `values`
+    - Values to write to the Excel sheet. If the value is a formula, it should start with "="
+    - ISO date strings (e.g., `"2026-02-03"`, `"2026-02-03T10:30:00"`, `"2026-02-03T10:30:00Z"`) are automatically converted to Excel date serial numbers
+
+### `excel_create_table`
+
+Create a table in the Excel sheet
+
+**Arguments:**
+- `fileAbsolutePath`
+    - Absolute path to the Excel file
+- `sheetName`
+    - Sheet name where the table is created
+- `range`
+    - Range to be a table (e.g., "A1:C10")
+- `tableName`
+    - Table name to be created
+
+### `excel_copy_sheet`
+
+Copy existing sheet to a new sheet
+
+**Arguments:**
+- `fileAbsolutePath`
+    - Absolute path to the Excel file
+- `srcSheetName`
+    - Source sheet name in the Excel file
+- `dstSheetName`
+    - Sheet name to be copied
+
+### `excel_format_range`
+
+Format cells in the Excel sheet with style information
+
+**Arguments:**
+- `fileAbsolutePath`
+    - Absolute path to the Excel file
+- `sheetName`
+    - Sheet name in the Excel file
+- `range`
+    - Range of cells in the Excel sheet (e.g., "A1:C3")
+- `styles`
+    - 2D array of style objects for each cell. If a cell does not change style, use null. The number of items of the array must match the range size.
+    - Style object properties:
+        - `border`: Array of border styles (type, color, style)
+        - `font`: Font styling (bold, italic, underline, size, strike, color, vertAlign)
+        - `fill`: Fill/background styling (type, pattern, color, shading)
+        - `alignment`: Cell alignment settings
+            - `horizontal`: Horizontal alignment (left, center, right, fill, justify, centerContinuous, distributed)
+            - `vertical`: Vertical alignment (top, center, bottom, justify, distributed)
+            - `wrapText`: Wrap text in cell (boolean)
+            - `shrinkToFit`: Shrink text to fit cell width (boolean)
+            - `textRotation`: Text rotation angle (0-180, or 255 for vertical)
+            - `indent`: Indent level (0-250)
+        - `numFmt`: Custom number format string
+        - `decimalPlaces`: Number of decimal places (0-30)
+
+<h2 id="configuration">Configuration</h2>
+
+You can change the MCP Server behaviors by the following environment variables:
+
+### `EXCEL_MCP_PAGING_CELLS_LIMIT`
+
+The maximum number of cells to read in a single paging operation.  
+[default: 4000]
+
+## License
+
+Copyright (c) 2025 Kazuki Negoro
+
+excel-mcp-server is released under the [MIT License](LICENSE)

package/dist/artifacts.json

@@ -0,0 +1 @@
+[{"name":"metadata.json","path":"dist/metadata.json","internal_type":35,"type":"Metadata"},{"name":"excel-mcp-server","path":"dist/excel-mcp-server_linux_386_sse2/excel-mcp-server","goos":"linux","goarch":"386","go386":"sse2","target":"linux_386_sse2","internal_type":4,"type":"Binary","extra":{"Binary":"excel-mcp-server","Builder":"go","Ext":"","ID":"excel-mcp-server"}},{"name":"excel-mcp-server.exe","path":"dist/excel-mcp-server_windows_386_sse2/excel-mcp-server.exe","goos":"windows","goarch":"386","go386":"sse2","target":"windows_386_sse2","internal_type":4,"type":"Binary","extra":{"Binary":"excel-mcp-server","Builder":"go","Ext":".exe","ID":"excel-mcp-server"}},{"name":"excel-mcp-server","path":"dist/excel-mcp-server_linux_arm64_v8.0/excel-mcp-server","goos":"linux","goarch":"arm64","goarm64":"v8.0","target":"linux_arm64_v8.0","internal_type":4,"type":"Binary","extra":{"Binary":"excel-mcp-server","Builder":"go","Ext":"","ID":"excel-mcp-server"}},{"name":"excel-mcp-server","path":"dist/excel-mcp-server_linux_amd64_v1/excel-mcp-server","goos":"linux","goarch":"amd64","goamd64":"v1","target":"linux_amd64_v1","internal_type":4,"type":"Binary","extra":{"Binary":"excel-mcp-server","Builder":"go","Ext":"","ID":"excel-mcp-server"}},{"name":"excel-mcp-server.exe","path":"dist/excel-mcp-server_windows_arm64_v8.0/excel-mcp-server.exe","goos":"windows","goarch":"arm64","goarm64":"v8.0","target":"windows_arm64_v8.0","internal_type":4,"type":"Binary","extra":{"Binary":"excel-mcp-server","Builder":"go","Ext":".exe","ID":"excel-mcp-server"}},{"name":"excel-mcp-server.exe","path":"dist/excel-mcp-server_windows_amd64_v1/excel-mcp-server.exe","goos":"windows","goarch":"amd64","goamd64":"v1","target":"windows_amd64_v1","internal_type":4,"type":"Binary","extra":{"Binary":"excel-mcp-server","Builder":"go","Ext":".exe","ID":"excel-mcp-server"}},{"name":"excel-mcp-server","path":"dist/excel-mcp-server_darwin_arm64_v8.0/excel-mcp-server","goos":"darwin","goarch":"arm64","goarm64":"v8.0","target":"darwin_arm64_v8.0","internal_type":4,"type":"Binary","extra":{"Binary":"excel-mcp-server","Builder":"go","Ext":"","ID":"excel-mcp-server"}},{"name":"excel-mcp-server","path":"dist/excel-mcp-server_darwin_amd64_v1/excel-mcp-server","goos":"darwin","goarch":"amd64","goamd64":"v1","target":"darwin_amd64_v1","internal_type":4,"type":"Binary","extra":{"Binary":"excel-mcp-server","Builder":"go","Ext":"","ID":"excel-mcp-server"}}]

package/dist/config.yaml

@@ -0,0 +1,158 @@
+version: 2
+project_name: excel-mcp-server
+release:
+  github:
+    owner: negokaz
+    name: excel-mcp-server
+  name_template: '{{.Tag}}'
+builds:
+  - id: excel-mcp-server
+    goos:
+      - linux
+      - windows
+      - darwin
+    goarch:
+      - amd64
+      - arm64
+      - "386"
+    goamd64:
+      - v1
+    go386:
+      - sse2
+    goarm:
+      - "6"
+    goarm64:
+      - v8.0
+    gomips:
+      - hardfloat
+    goppc64:
+      - power8
+    goriscv64:
+      - rva20u64
+    targets:
+      - linux_amd64_v1
+      - linux_arm64_v8.0
+      - linux_386_sse2
+      - windows_amd64_v1
+      - windows_arm64_v8.0
+      - windows_386_sse2
+      - darwin_amd64_v1
+      - darwin_arm64_v8.0
+    dir: .
+    main: ./cmd/excel-mcp-server/main.go
+    binary: excel-mcp-server
+    builder: go
+    tool: go
+    command: build
+    ldflags:
+      - -s -w -X main.version={{.Version}} -X main.commit={{.Commit}} -X main.date={{.Date}} -X main.builtBy=goreleaser
+    env:
+      - CGO_ENABLED=0
+archives:
+  - id: default
+    builds_info:
+      mode: 493
+    name_template: '{{ .ProjectName }}_ {{- title .Os }}_ {{- if eq .Arch "amd64" }}x86_64 {{- else if eq .Arch "386" }}i386 {{- else }}{{ .Arch }}{{ end }} {{- if .Arm }}v{{ .Arm }}{{ end }}'
+    formats:
+      - tar.gz
+    format_overrides:
+      - goos: windows
+        formats:
+          - zip
+    files:
+      - src: license*
+      - src: LICENSE*
+      - src: readme*
+      - src: README*
+      - src: changelog*
+      - src: CHANGELOG*
+snapshot:
+  version_template: '{{ .Version }}-SNAPSHOT-{{ .ShortCommit }}'
+checksum:
+  name_template: '{{ .ProjectName }}_{{ .Version }}_checksums.txt'
+  algorithm: sha256
+docker_digest:
+  name_template: digests.txt
+changelog:
+  filters:
+    exclude:
+      - '^docs:'
+      - '^test:'
+  sort: asc
+  format: '{{ .SHA }} {{ .Message }}'
+dist: dist
+env_files:
+  github_token: ~/.config/goreleaser/github_token
+  gitlab_token: ~/.config/goreleaser/gitlab_token
+  gitea_token: ~/.config/goreleaser/gitea_token
+before:
+  hooks:
+    - go mod tidy
+    - go generate ./...
+source:
+  name_template: '{{ .ProjectName }}-{{ .Version }}'
+  format: tar.gz
+gomod:
+  gobinary: go
+announce:
+  twitter:
+    message_template: '{{ .ProjectName }} {{ .Tag }} is out! Check it out at {{ .ReleaseURL }}'
+  mastodon:
+    message_template: '{{ .ProjectName }} {{ .Tag }} is out! Check it out at {{ .ReleaseURL }}'
+    server: ""
+  reddit:
+    title_template: '{{ .ProjectName }} {{ .Tag }} is out!'
+    url_template: '{{ .ReleaseURL }}'
+  slack:
+    message_template: '{{ .ProjectName }} {{ .Tag }} is out! Check it out at {{ .ReleaseURL }}'
+    username: GoReleaser
+  discord:
+    message_template: '{{ .ProjectName }} {{ .Tag }} is out! Check it out at {{ .ReleaseURL }}'
+    author: GoReleaser
+    color: "3888754"
+    icon_url: https://goreleaser.com/static/avatar.png
+  teams:
+    title_template: '{{ .ProjectName }} {{ .Tag }} is out!'
+    message_template: '{{ .ProjectName }} {{ .Tag }} is out! Check it out at {{ .ReleaseURL }}'
+    color: '#2D313E'
+    icon_url: https://goreleaser.com/static/avatar.png
+  smtp:
+    subject_template: '{{ .ProjectName }} {{ .Tag }} is out!'
+    body_template: 'You can view details from: {{ .ReleaseURL }}'
+  mattermost:
+    message_template: '{{ .ProjectName }} {{ .Tag }} is out! Check it out at {{ .ReleaseURL }}'
+    title_template: '{{ .ProjectName }} {{ .Tag }} is out!'
+    username: GoReleaser
+  linkedin:
+    message_template: '{{ .ProjectName }} {{ .Tag }} is out! Check it out at {{ .ReleaseURL }}'
+  telegram:
+    message_template: '{{ mdv2escape .ProjectName }} {{ mdv2escape .Tag }} is out{{ mdv2escape "!" }} Check it out at {{ mdv2escape .ReleaseURL }}'
+    parse_mode: MarkdownV2
+  webhook:
+    message_template: '{ "message": "{{ .ProjectName }} {{ .Tag }} is out! Check it out at {{ .ReleaseURL }}"}'
+    content_type: application/json; charset=utf-8
+    expected_status_codes:
+      - 200
+      - 201
+      - 202
+      - 204
+  opencollective:
+    title_template: '{{ .Tag }}'
+    message_template: '{{ .ProjectName }} {{ .Tag }} is out!<br/>Check it out at <a href="{{ .ReleaseURL }}">{{ .ReleaseURL }}</a>'
+  bluesky:
+    message_template: '{{ .ProjectName }} {{ .Tag }} is out! Check it out at {{ .ReleaseURL }}'
+  discourse:
+    title_template: '{{ .ProjectName }} {{ .Tag }} is out!'
+    message_template: '{{ .ProjectName }} {{ .Tag }} is out! Check it out at {{ .ReleaseURL }}'
+    username: system
+git:
+  tag_sort: -version:refname
+mcp:
+  name: ""
+  title: ""
+  auth:
+    type: none
+github_urls:
+  download: https://github.com
+gitlab_urls:
+  download: https://gitlab.com

package/dist/launcher.js

@@ -0,0 +1,61 @@
+#!/usr/bin/env node
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const path = __importStar(require("path"));
+const childProcess = __importStar(require("child_process"));
+const BINARY_DISTRIBUTION_PACKAGES = {
+    win32_ia32: "excel-mcp-server_windows_386_sse2",
+    win32_x64: "excel-mcp-server_windows_amd64_v1",
+    win32_arm64: "excel-mcp-server_windows_arm64_v8.0",
+    darwin_x64: "excel-mcp-server_darwin_amd64_v1",
+    darwin_arm64: "excel-mcp-server_darwin_arm64_v8.0",
+    linux_ia32: "excel-mcp-server_linux_386_sse2",
+    linux_x64: "excel-mcp-server_linux_amd64_v1",
+    linux_arm64: "excel-mcp-server_linux_arm64_v8.0",
+};
+function getBinaryPath() {
+    const suffix = process.platform === 'win32' ? '.exe' : '';
+    const pkg = BINARY_DISTRIBUTION_PACKAGES[`${process.platform}_${process.arch}`];
+    if (pkg) {
+        return path.resolve(__dirname, pkg, `excel-mcp-server${suffix}`);
+    }
+    else {
+        throw new Error(`Unsupported platform: ${process.platform}_${process.arch}`);
+    }
+}
+childProcess.execFileSync(getBinaryPath(), process.argv, {
+    stdio: 'inherit',
+});

package/dist/metadata.json

@@ -0,0 +1 @@
+{"project_name":"excel-mcp-server","tag":"v0.14.0","previous_tag":"v0.12.0","version":"0.14.0-SNAPSHOT-5a997a0","commit":"5a997a08f2f28713df99c467fde5715007bf963a","date":"2026-02-05T08:10:23.439288+01:00","runtime":{"goos":"darwin","goarch":"arm64"}}

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "excel-mcp-server-pcvelz",
+  "version": "0.15.0",
+  "description": "An MCP server that reads and writes spreadsheet data to MS Excel file",
+  "author": "negokaz",
+  "license": "MIT",
+  "bin": {
+    "excel-mcp-server": "dist/launcher.js"
+  },
+  "files": [
+    "dist/"
+  ],
+  "scripts": {
+    "build": "goreleaser build --snapshot --clean && tsc",
+    "prepublishOnly": "npm run build",
+    "watch": "tsc --watch",
+    "debug": "npx @modelcontextprotocol/inspector dist/launcher.js"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.4",
+    "typescript": "^5.7.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}