{"_id":"solana-mcp","_rev":"2-91ed97652b56f07a2414b671870ef095","name":"solana-mcp","dist-tags":{"latest":"1.0.1"},"versions":{"1.0.0":{"name":"solana-mcp","version":"1.0.0","keywords":["solana","mcp","solana-agent-kit","solana-mcp"],"author":{"name":"sendaifun"},"license":"MIT","_id":"solana-mcp@1.0.0","maintainers":[{"name":"0xaryan","email":"agarwalaryan139@gmail.com"}],"homepage":"https://github.com/sendaifun/solana-mcp#readme","bugs":{"url":"https://github.com/sendaifun/solana-mcp/issues"},"bin":{"solana-mcp":"build/index.js"},"dist":{"shasum":"9d2dcab7a0e62541f100ce89e748e726967f15e7","tarball":"https://registry.npmjs.org/solana-mcp/-/solana-mcp-1.0.0.tgz","fileCount":3,"integrity":"sha512-4I0CUgFzeaL0RVA17gD7lLc5SaW0A2kq2mBnWE85t/YlE9RAiW5vmVQiU/3ZHCO2EeR8frf3/dnBL81IXw0olQ==","signatures":[{"sig":"MEQCIDJ+XCXurVR52uX/2IrYGZibsw6QFo5LnkGiJsVsbp9SAiB0t6dGL0hvjcqvVvV5Cw8b+qnR8+q9Mi3ci6/kt4BUvA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":8485},"main":"build/index.js","type":"module","_from":"file:solana-mcp-1.0.0.tgz","scripts":{"dev":"tsx watch src/index.ts","build":"tsc && node -e \"require('fs').chmodSync('build/index.js', '755')\"","start":"node build/index.js"},"_npmUser":{"name":"0xaryan","email":"agarwalaryan139@gmail.com"},"_resolved":"/private/var/folders/8r/w56fq6zs4w3_ng6gb68p8zp80000gn/T/12bf32c67af053115d486afd6a8cf214/solana-mcp-1.0.0.tgz","_integrity":"sha512-4I0CUgFzeaL0RVA17gD7lLc5SaW0A2kq2mBnWE85t/YlE9RAiW5vmVQiU/3ZHCO2EeR8frf3/dnBL81IXw0olQ==","repository":{"url":"git+https://github.com/sendaifun/solana-mcp.git","type":"git"},"_npmVersion":"10.9.0","description":"A Model Context Protocol server for interacting with the Solana blockchain, powered by the [Solana Agent Kit](https://github.com/sendaifun/solana-agent-kit)","directories":{},"_nodeVersion":"22.12.0","dependencies":{"zod":"^3.24.2","dotenv":"^16.4.7","solana-agent-kit":"1.4.8","@modelcontextprotocol/sdk":"^1.5.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.3","@types/node":"^22.13.4"},"_npmOperationalInternal":{"tmp":"tmp/solana-mcp_1.0.0_1741612985939_0.846338175066643","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"solana-mcp","version":"1.0.1","description":"A Model Context Protocol server for interacting with the Solana blockchain, powered by the Solana Agent Kit (https://github.com/sendaifun/solana-agent-kit)","main":"build/index.js","type":"module","bin":{"solana-mcp":"build/index.js"},"repository":{"type":"git","url":"git+https://github.com/sendaifun/solana-mcp.git"},"keywords":["solana","mcp","solana-agent-kit","solana-mcp"],"author":{"name":"sendaifun"},"license":"MIT","dependencies":{"dotenv":"^16.4.7","solana-agent-kit":"1.4.9"},"devDependencies":{"@types/node":"^22.13.4","typescript":"^5.7.3"},"scripts":{"build":"tsc","start":"node build/index.js","dev":"tsx watch src/index.ts"},"_id":"solana-mcp@1.0.1","bugs":{"url":"https://github.com/sendaifun/solana-mcp/issues"},"homepage":"https://github.com/sendaifun/solana-mcp#readme","_integrity":"sha512-FkJ/Ts/hgD9VprHJGIZsB0vwO/jmC4VPX3kJmOoXiGBs4j1h/2dPSwrIlkUq28kzTL5GQfHSw7/AxnU9Xbf8RA==","_resolved":"/private/var/folders/8r/w56fq6zs4w3_ng6gb68p8zp80000gn/T/90e298b62ad71da92b9744f40270c2e5/solana-mcp-1.0.1.tgz","_from":"file:solana-mcp-1.0.1.tgz","_nodeVersion":"22.12.0","_npmVersion":"10.9.0","dist":{"integrity":"sha512-FkJ/Ts/hgD9VprHJGIZsB0vwO/jmC4VPX3kJmOoXiGBs4j1h/2dPSwrIlkUq28kzTL5GQfHSw7/AxnU9Xbf8RA==","shasum":"692e5ba9fee55c9f97b014622bc35125211f4b67","tarball":"https://registry.npmjs.org/solana-mcp/-/solana-mcp-1.0.1.tgz","fileCount":3,"unpackedSize":8552,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIBUR/74VGzY8Nr6N6J5+VCUKdJbYAl2iTjb4dPR/WELdAiEA099EfgLtgpWo9ZTKZcPZw1S9stNqpbj1OkkdnVCkSV0="}]},"_npmUser":{"name":"0xaryan","email":"agarwalaryan139@gmail.com"},"directories":{},"maintainers":[{"name":"0xaryan","email":"agarwalaryan139@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/solana-mcp_1.0.1_1744293156106_0.34743993099187653"},"_hasShrinkwrap":false}},"time":{"created":"2025-03-10T13:23:05.937Z","modified":"2025-04-10T13:52:36.427Z","1.0.0":"2025-03-10T13:23:06.140Z","1.0.1":"2025-04-10T13:52:36.283Z"},"bugs":{"url":"https://github.com/sendaifun/solana-mcp/issues"},"author":{"name":"sendaifun"},"license":"MIT","homepage":"https://github.com/sendaifun/solana-mcp#readme","keywords":["solana","mcp","solana-agent-kit","solana-mcp"],"repository":{"type":"git","url":"git+https://github.com/sendaifun/solana-mcp.git"},"description":"A Model Context Protocol server for interacting with the Solana blockchain, powered by the Solana Agent Kit (https://github.com/sendaifun/solana-agent-kit)","maintainers":[{"name":"0xaryan","email":"agarwalaryan139@gmail.com"}],"readme":"# Solana Agent Kit MCP Server\n\n[![npm version](https://badge.fury.io/js/solana-mcp.svg)](https://www.npmjs.com/package/solana-mcp)\n[![License: ISC](https://img.shields.io/badge/License-ISC-blue.svg)](https://opensource.org/licenses/ISC)\n\nA Model Context Protocol (MCP) server that provides onchain tools for Claude AI, allowing it to interact with the Solana blockchain through a standardized interface. This implementation is based on the Solana Agent Kit and enables AI agents to perform blockchain operations seamlessly.\n\n## Overview\n\nThis MCP server extends Claude's capabilities by providing tools to:\n\n* Interact with Solana blockchain\n* Execute transactions\n* Query account information\n* Manage Solana wallets\n\nThe server implements the Model Context Protocol specification to standardize blockchain interactions for AI agents.\n\n## Prerequisites\n\n* Node.js (v16 or higher)\n* pnpm (recommended), npm, or yarn\n* Solana wallet with private key\n* Solana RPC URL (mainnet, testnet, or devnet)\n\n## Installation\n\n### Option 1: Quick Install (Recommended)\n\n```bash\n# Download the installation script\ncurl -fsSL https://raw.githubusercontent.com/sendaifun/solana-mcp/main/scripts/install.sh -o solana-mcp-install.sh\n\n# Make it executable and run\nchmod +x solana-mcp-install.sh && ./solana-mcp-install.sh --backup\n```\n\nThis will start an interactive installation process that will guide you through:\n- Setting up Node.js if needed\n- Configuring your Solana RPC URL and private key\n- Setting up the Claude Desktop integration\n\n### Option 2: Install from npm ( recommend for clients like Cursor/Cline)\n\n```bash\n# Install globally\nnpm install -g solana-mcp\n\n# Or install locally in your project\nnpm install solana-mcp\n```\n\n### Option 3: Build from Source\n\n1. Clone this repository:\n```bash\ngit clone https://github.com/sendaifun/solana-mcp\ncd solana-mcp\n```\n\n2. Install dependencies:\n```bash\npnpm install\n```\n\n3. Build the project:\n```bash\npnpm run build\n```\n\n## Configuration\n\n### Environment Setup\n\nCreate a `.env` file with your credentials:\n\n```env\n# Solana Configuration\nSOLANA_PRIVATE_KEY=your_private_key_here\nRPC_URL=your_solana_rpc_url_here\nOPENAI_API_KEY=your_openai_api_key # OPTIONAL\n```\n\n### Integration with Claude Desktop\n\nTo add this MCP server to Claude Desktop, follow these steps:\n\n1. **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\n2. **Add the Configuration**\n   Create or edit the configuration file and add the following JSON:\n\n   If you installed via npm (Option 1):\n   ```json\n   {\n     \"mcpServers\": {\n       \"solana-mcp\": {\n         \"command\": \"npx\",\n         \"args\": [\"solana-mcp\"],\n         \"env\": {\n           \"RPC_URL\": \"your_solana_rpc_url_here\",\n           \"SOLANA_PRIVATE_KEY\": \"your_private_key_here\",\n           \"OPENAI_API_KEY\": \"your_openai_api_key\"  // OPTIONAL\n         },\n         \"disabled\": false,\n         \"autoApprove\": []\n       }\n     }\n   }\n   ```\n\n   If you built from source (Option 2):\n   ```json\n   {\n     \"mcpServers\": {\n       \"solana-mcp\": {\n         \"command\": \"node\",\n         \"args\": [\"/path/to/solana-mcp/build/index.js\"],\n         \"env\": {\n           \"RPC_URL\": \"your_solana_rpc_url_here\",\n           \"SOLANA_PRIVATE_KEY\": \"your_private_key_here\",\n           \"OPENAI_API_KEY\": \"your_openai_api_key\"  // OPTIONAL\n         },\n         \"disabled\": false,\n         \"autoApprove\": []\n       }\n     }\n   }\n   ```\n\n3. **Restart Claude Desktop**\n   After making these changes, restart Claude Desktop for the configuration to take effect.\n\n## Project Structure\n\n```\nsolana-agent-kit-mcp/\n├── src/\n│   ├── index.ts          # Main entry point\n├── package.json\n└── tsconfig.json\n```\n\n## Available Tools\n\nThe MCP server provides the following Solana blockchain tools:\n\n* `GET_ASSET` - Retrieve information about a Solana asset/token\n* `DEPLOY_TOKEN` - Deploy a new token on Solana\n* `GET_PRICE` - Fetch price information for tokens\n* `WALLET_ADDRESS` - Get the wallet address\n* `BALANCE` - Check wallet balance\n* `TRANSFER` - Transfer tokens between wallets\n* `MINT_NFT` - Create and mint new NFTs\n* `TRADE` - Execute token trades\n* `REQUEST_FUNDS` - Request funds (useful for testing/development)\n* `RESOLVE_DOMAIN` - Resolve Solana domain names\n* `GET_TPS` - Get current transactions per second on Solana\n\n## Security Considerations\n\n* Keep your private key secure and never share it\n* Use environment variables for sensitive information\n* Consider using a dedicated wallet for AI agent operations\n* Regularly monitor and audit AI agent activities\n* Test operations on devnet/testnet before mainnet\n\n## Troubleshooting\n\nIf you encounter issues:\n\n1. Verify your Solana private key is correct\n2. Check your RPC URL is accessible\n3. Ensure you're on the intended network (mainnet, testnet, or devnet)\n4. Check Claude Desktop logs for error messages\n5. Verify the build was successful\n\n## Dependencies\n\nKey dependencies include:\n* [@solana/web3.js](https://github.com/solana-labs/solana-web3.js)\n* [@modelcontextprotocol/sdk](https://github.com/modelcontextprotocol/typescript-sdk)\n* [solana-agent-kit](https://github.com/sendaifun/solana-agent-kit)\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add some amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n## License\n\nThis project is licensed under the MIT License.\n","readmeFilename":"README.md"}