siwatsystem-mcp-dxt/GEMINI.md
Siwat Sirichai 3767f424fe
All checks were successful
Build and Package DXT / build (push) Successful in 31s
feat: add initial documentation for Siwat System MCP DXT extension
2025-07-06 17:21:16 +07:00

29 lines
1.7 KiB
Markdown

## Project: siwatsystem-mcp-dxt
This project is a Claude DXT extension for the Siwat System API. It allows users to interact with the Siwat System API through Claude.
### Files
* **`package.json`**: Defines the project's dependencies and scripts.
* **`tsconfig.json`**: Configures the TypeScript compiler.
* **`build.ts`**: A script for building the DXT extension. It uses `@vercel/ncc` to bundle the code and `archiver` to create the `.dxt` file.
* **`.gitea/workflows/build.yml`**: A Gitea workflow for building and packaging the DXT extension.
* **`assets/manifest.json`**: The manifest file for the DXT extension. It defines the extension's metadata, server configuration, and user-configurable settings.
* **`assets/icon.png`**: The icon for the DXT extension.
* **`.gitignore`**: Specifies which files and directories to ignore in Git.
### How it works
The DXT extension works by running a local MCP (Model Control Protocol) server that proxies requests to the Siwat System API. The `build.ts` script bundles the `mcp-remote` package, which is a generic MCP server, into a single `index.js` file. This file is then packaged into a `.dxt` file along with the `manifest.json` and `icon.png`.
When a user installs the `.dxt` file in Claude Desktop, Claude starts the MCP server and uses the information in the `manifest.json` to configure it. The user is prompted to enter their Siwat System API key, which is then used to authenticate with the Siwat System API.
### How to build
To build the DXT extension, run the following command:
```
bun build.ts
```
This will create a `dist` directory containing the bundled `index.js` file and the `siwat_system_mcp.dxt` file.