{"id":30093464,"url":"https://github.com/apillon/mcp-server","last_synced_at":"2025-08-09T09:42:15.416Z","repository":{"id":289663977,"uuid":"962636308","full_name":"Apillon/mcp-server","owner":"Apillon","description":null,"archived":false,"fork":false,"pushed_at":"2025-06-23T09:39:26.000Z","size":216,"stargazers_count":1,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-07-01T01:06:17.869Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Apillon.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-04-08T12:59:04.000Z","updated_at":"2025-06-23T09:39:30.000Z","dependencies_parsed_at":"2025-04-24T12:46:12.442Z","dependency_job_id":"dd2b1678-95d4-41a8-bd62-39857074e8d3","html_url":"https://github.com/Apillon/mcp-server","commit_stats":null,"previous_names":["apillon/mcp-server"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Apillon/mcp-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Apillon%2Fmcp-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Apillon%2Fmcp-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Apillon%2Fmcp-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Apillon%2Fmcp-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Apillon","download_url":"https://codeload.github.com/Apillon/mcp-server/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Apillon%2Fmcp-server/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":269560041,"owners_count":24438179,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-09T02:00:10.424Z","response_time":111,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-08-09T09:42:14.658Z","updated_at":"2025-08-09T09:42:15.397Z","avatar_url":"https://github.com/Apillon.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Apillon MCP Server\n\n[![npm version](https://badge.fury.io/js/@apillon%2Fmcp-server.svg)](https://badge.fury.io/js/@apillon%2Fmcp-server)\n\nWelcome to the Apillon MCP Server repository. This project implements a server using the Model Context Protocol (MCP) to provide modules for Storage, Hosting, and NFT functionalities.\n\n## Introduction to Model Context Protocol (MCP)\n\nThe Model Context Protocol (MCP) is an open protocol that standardizes how applications provide context to Large Language Models (LLMs). Think of MCP like a USB-C port for AI applications. Just as USB-C provides a standardized way to connect your devices to various peripherals and accessories, MCP provides a standardized way to connect AI models to different data sources and tools.\n\nMCP helps you build agents and complex workflows on top of LLMs. LLMs frequently need to integrate with data and tools, and MCP provides:\n\n- A growing list of pre-built integrations that your LLM can directly plug into.\n- The flexibility to switch between LLM providers and vendors.\n- Best practices for securing your data within your infrastructure.\n\nFor more information, visit the [Model Context Protocol Introduction](https://modelcontextprotocol.io/introduction).\n\n## Project Overview\n\nThis project is developed by Apillon and provides a server implementation for the following modules:\n\n### Storage Module\nThe Storage module provides comprehensive file management capabilities:\n- Create and manage storage buckets\n- Upload files and folders with support for directory structures\n- List and manage objects (files and folders) within buckets\n- Generate IPFS links for content addressing\n- Manage IPNS records for persistent naming\n- Delete files and directories\n- Track file status and metadata\n\n### Hosting Module\nThe Hosting module enables web application deployment:\n- Create and manage website instances\n- Upload website files from local folders or buffers\n- Deploy to staging and production environments\n- Monitor deployment status\n- List and manage deployments\n- Support for multiple deployment environments\n\n### NFT Module\nThe NFT module provides comprehensive NFT management:\n- Create NFT collections on various chains (EVM, Substrate, Unique)\n- Configure collection parameters (name, symbol, royalties, etc.)\n- Mint NFTs to specific addresses\n- Support for nested NFTs (nestable collections)\n- Burn/revoke NFTs (for revokable collections)\n- Transfer collection ownership\n- Monitor transaction status\n- Support for drops with configurable parameters\n\n## Using with Claude\n\nTo use this MCP with the Claude LLM, follow these steps:\n\n1. **Install [Claude for Desktop](https://claude.ai/download)**\n\n2. **Locate the Claude Desktop Configuration File**\n  - macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`\n  - Windows: `%APPDATA%\\Claude\\claude_desktop_config.json`\n  - Linux: `~/.config/Claude/claude_desktop_config.json`\n\n3. **Add the Configuration**\n\nCopy the configuration from [claude_desktop_config.json](./claude_desktop_config.json) and adjust it with your own parameters.\n\n\u003e ⚠️ **Important:** Make sure to modify the API key env variables and the allowed directories for the filesystem MCP.\n\n```json\n{\n  \"mcpServers\": {\n    \"apillon-mcp-server\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@apillon/mcp-server\"],\n      \"env\": {\n        \"APILLON_API_KEY\": \"\u003cAPILLON_API_KEY\u003e\",\n        \"APILLON_API_SECRET\": \"\u003cAPILLON_API_SECRET\u003e\"\n      }\n    },\n    \"filesystem\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"@modelcontextprotocol/server-filesystem\",\n        \"/Users/your-username/Desktop\"\n      ]\n    }\n  }\n}\n```\n\n4. **Restart Claude for Desktop**\n\nAfter making these changes, restart Claude Desktop for the configuration to take effect.\nYou can now prompt Claude to perform any of the available actions using only the text chat.\n\n## Local development\n\n### Prerequisites\n\n- Node.js 22 or higher\n- npm 11 or higher\n- TypeScript\n- Apillon API key and secret (can be generated on https://app.apillon.io)\n\n### Installation\n\nClone the repository and install the dependencies:\n\n```bash\ngit clone https://github.com/Apillon/mcp-server.git\ncd mcp-server\nnpm install\n```\n\n### Modify your local claude desktop config:\n```json\n{\n  \"mcpServers\": {\n    \"apillon-mcp-server\": {\n      \"command\": \"tsx\",\n      \"args\": [\"/full/path/to/index.ts\"],\n      \"env\": {\n        \"APILLON_API_KEY\": \"\u003cAPILLON_API_KEY\u003e\",\n        \"APILLON_API_SECRET\": \"\u003cAPILLON_API_SECRET\u003e\"\n      }\n    }\n  }\n}\n\n```\n### Running the Server\n\n**The preferred metho to test your server is to use Claude Dekstop with the above config.**\nAlternatively, to start the server locally, use the following command,\n\n```bash\nnpm start\n```\n\n### Building the Project\n\nTo build the project, run:\n\n```bash\nnpm run build\n```\n\n## Contributing\n\nWe welcome contributions to the Apillon MCP Server. Please check the [issues](https://github.com/Apillon/mcp-server/issues) for any open tasks or bugs.\n\n## License\n\nThis project is licensed under the MIT License.\n\n## MCP Review\n\nThis MCP server is certified by [MCP review](https://mcpreview.com)\n\nVisit our own [MCP Review page](https://mcpreview.com/mcp-servers/apillon/mcp-server)\n\n## Contact\n\nFor more information, visit [Apillon's website](https://apillon.io) or reach out via [GitHub issues](https://github.com/Apillon/mcp-server/issues).\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapillon%2Fmcp-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fapillon%2Fmcp-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapillon%2Fmcp-server/lists"}