Codigma MCP Server

Welcome to the Codigma MCP Server repository!

Codigma MCP Server is the backend service behind Codigma.io — a free tool that helps you easily turn any public Figma link into clean, semantic HTML and CSS.

You just paste your Figma link, and Codigma.io does the rest!

---

🔄 What You Can Do

- Fetch Figma public file data.
- Convert Figma designs into structured Codigma Models.
- Generate clean, semantic HTML and CSS code.
- Optionally generate TailwindCSS class-based HTML.
- Support for responsive design, fonts, borders, shadows, and gradients.

---

📚 Quick Start

1. Clone the repository

git clone https://github.com/rastmob/codigma-mcp-server.git
cd codigma-mcp-server

2. Install dependencies

npm install

3. Add Figma API token

Create a .env file:

FIGMA_PERSONAL_ACCESS_TOKEN=your_figma_token_here

How to get a Figma Token?

4. Run the server

Development mode

npm run dev

Production mode

npm run build
npm start

---

🌐 Main API Endpoints

| Endpoint | Method | Description |
|:---|:---|:---|
| /api/fetch-figma-data | POST | Fetch public Figma file JSON data. |
| /api/map-figma-node | POST | Convert Figma Node to Codigma Model. |
| /api/generate-html | POST | Create HTML from Codigma Model. |
| /api/generate-css | POST | Create CSS from Codigma Model. |
| /api/generate-bundle | POST | Create full bundle (HTML + CSS). |
| /api/figma-to-bundle | POST | Full process from Figma URL to code output (supports TailwindCSS too). |

---

📅 Example

POST /api/figma-to-bundle

Request Body:

{

  "figmaUrl": "https://www.figma.com/file/abcd1234/Design-System?node-id=123%3A456",

  "outputType": "plain" // or "tailwind"

}

Response:
- Codigma Model (structured)
- HTML + CSS bundle (or TailwindCSS HTML)

---

🔧 Technology

- Node.js 18+
- Express 5
- TypeScript
- Axios
- Jest (for tests)
- ESLint (for code quality)

---

📊 Roadmap

- ✅ Fetch public Figma files
- ✅ TailwindCSS output option
- ✅ Font, border, shadow support
- ⬆️ Better responsive support
- ⬆️ OAuth login for private files
- ⬆️ Snapshot and versioning features
- ⬆️ Admin Dashboard

---

👤 About the Author

Mehmet Alp
Founder of Rast Mobile

- GitHub: @rastmob
- Email: mehmet.alp@rastmobile.com

---

📄 License

Licensed under the ISC License.

---

📈 Contributing

We welcome pull requests!

> Fork the repo → Create a branch → Commit your changes → Open a pull request → Done! 📚

---

🐝 Reporting Bugs

Found a bug? Please open an issue here.

Thanks for using Codigma MCP Server!
And don't forget to try Codigma.io for FREE!