josectoscano/stellar-mcp

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

6 stars 5 forks Качество 53 Тренд 14

Обзор

A Model Context Protocol (MCP) ecosystem for the Stellar blockchain. Generate production-ready MCP servers from any deployed Soroban contract, connect them to AI agents, and interact via a type-safe SDK or ready-to-deploy templates. Each template is a standalone project you copy, configure with a .env, and deploy. An AI agent (Claude or GPT-4) that connects to your MCP server and handles Telegram messages. Deploys to Vercel in one command. Next.js 15 app with a PasskeyKit smart wallet. Users authenticate with a passkey (no seed phrase) and interact with MCP tools through a chat-style UI. Terminal agent for any MCP server. Guided wizard, REPL loop, JSON output, and inline one-shot mode. Generated servers support Docker out of the box. Environment variables supported by all generated servers: See docs/security.md for hardening guidance.

README

Показан фрагмент оригинального README. Открыть оригинал.

stellar-mcp

What’s in this repo

Component	Path	Description
MCP Generator	`stellar-mcp-generator/`	Rust CLI plugin — generates TypeScript or Python MCP servers from any deployed Soroban contract
SDK	`packages/client/`	`@stellar-mcp/client` — type-safe programmatic client for generated MCP servers
Telegram Bot template	`templates/telegram-bot/`	Vercel-deployable Telegram bot powered by an AI agent + MCP server
Smart Wallet template	`templates/smart-wallet/`	Next.js 15 app with PasskeyKit smart wallet and MCP tool browser
CLI Agent template	`templates/cli-agent/`	Terminal agent — list tools, call them interactively or one-shot from any shell
Standalone MCP server	`src/`	Original stdio MCP server for Claude Desktop (account management, Soroban transactions)
Policy CLI	`stellar-policy-cli/`	Rust CLI — generates Soroban policy contracts to restrict what a signing key can authorize

Quick Start

1. Generate an MCP server from a contract

# Install the Stellar CLI plugin
cargo install --path stellar-mcp-generator

# Generate a TypeScript MCP server
stellar mcp generate \
  --contract-id CAHLJEQUCNTV7JPAPCMLCBIHOX7FFB57DUARJ6XGTW27FPCVKKY7JM2A \
  --rpc-url https://soroban-testnet.stellar.org \
  --network-passphrase "Test SDF Network ; September 2015" \
  --output ./my-mcp-server

cd my-mcp-server && npm install && npm run build

2. Run the generated server

# stdio mode (Claude Desktop)
node dist/index.js

# HTTP mode (web frontends, CLI agent, Telegram bot)
USE_HTTP=true PORT=3000 node dist/index.js

3. Connect via SDK

npm install @stellar-mcp/client

import { MCPClient, secretKeySigner } from '@stellar-mcp/client';

const client = new MCPClient({
  url: 'http://localhost:3000/mcp',
  networkPassphrase: 'Test SDF Network ; September 2015',
  rpcUrl: 'https://soroban-testnet.stellar.org',
});

const tools = await client.listTools();
const { data } = await client.call('get-admin');
const { xdr } = await client.call('deploy-token', { deployer: 'G...' });
const result = await client.signAndSubmit(xdr!, {
  signer: secretKeySigner(process.env.SECRET_KEY!),
});
client.close();

Templates

Each template is a standalone project you copy, configure with a .env, and deploy.

Telegram Bot (`templates/telegram-bot/`)

An AI agent (Claude or GPT-4) that connects to your MCP server and handles Telegram messages. Deploys to Vercel in one command.

cd templates/telegram-bot
cp .env.example .env   # set MCP_SERVER_URL, BOT_TOKEN, ANTHROPIC_API_KEY
vercel deploy

Smart Wallet (`templates/smart-wallet/`)

Открыть полный README на GitHub

Установка

docker run -p 3000:3000 \

Новичок в MCP? Начните с руководства на mcpskill.org →