Stellar Studio MCP服务器

通过对话部署和命令Stellar令牌、NFT和DAO。

模型上下文协议后端，将自然语言转化为Stellar合约部署、操作和治理流程。

![License: MIT](LICENSE) ![TypeScript](https://www.typescriptlang.org/) ![MCP](https://modelcontextprotocol.io)

快速开始 • 建筑 • 用法示例 • 工具

______________________________________________________________________

概述

模型上下文协议（MCP）服务器，使AI助手能够通过自然语言命令与Stellar区块链进行交互。该服务器提供全面的智能合约部署、令牌操作、NFT管理、治理执行和注册工具，因此构建者可以通过对话协调Stellar dApps。

它的作用：

将80多个区块链操作作为MCP工具公开
管理工厂合同交互（令牌、NFT、治理）
处理交易构建、模拟和签名
为治理投票生成默克尔证明
提供合约部署实用程序和注册表集成

它的力量：

AI聊天界面（光标、克劳德桌面、VS代码）
自然语言区块链操作
自动化合同部署工作流程
通过对话进行区块链数据查询

______________________________________________________________________

建筑

系统设计

graph TB
    subgraph "AI Clients"
        C1[Cursor IDE]
        C2[Claude Desktop]
        C3[VS Code]
    end

    subgraph "MCP Server Layer"
        MCP[MCP Server Core]
        TR[Tool Registry
80+ Tools]
        SC[Stellar Client
SDK Wrapper]
    end

    subgraph "Plugin System"
        P1[Factory Plugin
1 tool]
        P2[Token Plugin
5 tools]
        P3[NFT Plugin
5 tools]
        P4[Governance Plugin
5 tools]
        P5[Registry Plugin
6 tools]
        P6[Token Contract Plugin
15 tools]
        P7[NFT Contract Plugin
17 tools]
        P8[Governance Contract Plugin
3 tools]
        P9[Utilities Plugin
15 tools]
    end

    subgraph "Stellar Network"
        F1[Token Factory]
        F2[NFT Factory]
        F3[Governance Factory]
        F4[Registry Contract]
        RPC[Stellar RPC
Soroban]
    end

    C1 & C2 & C3 --> MCP
    MCP --> TR
    TR --> P1 & P2 & P3 & P4 & P5 & P6 & P7 & P8 & P9
    P1 & P2 & P3 & P4 & P5 & P6 & P7 & P8 --> SC
    SC --> F1 & F2 & F3 & F4
    SC --> RPC

    style MCP fill:#7D00FF,color:#fff
    style TR fill:#4CAF50,color:#fff
    style SC fill:#2196F3,color:#fff

工具执行流程

sequenceDiagram
    participant AI as AI Client
    participant MCP as MCP Server
    participant Plugin as Tool Plugin
    participant Stellar as Stellar SDK
    participant Network as Stellar Network

    AI->>MCP: Call token_deploy tool
    MCP->>Plugin: Route to TokenService
    Plugin->>Plugin: Validate parameters
    Plugin->>Stellar: Build transaction
    Stellar->>Network: Simulate transaction
    Network-->>Stellar: Gas estimate
    Stellar->>Network: Sign & submit
    Network-->>Stellar: Transaction hash
    Stellar-->>Plugin: Contract address
    Plugin-->>MCP: Success response
    MCP-->>AI: Tool result + suggestion

插件架构

服务器使用模块化插件系统按域组织工具：

工厂插件 （1个工具）：

工厂合同部署跟踪

令牌插件 （5个工具）：

通过TokenFactory部署令牌
工厂查询（计数、列表、按类型/管理员筛选）

NFT插件 （5个工具）：

通过NFTFactory部署NFT集合
工厂查询（计数、列表、按类型/所有者筛选）

治理插件 （5个工具）：

通过GovernanceFactory进行治理部署
工厂查询（计数、列表、按类型/管理员筛选）

注册表插件 （6个工具）：

将编译好的合约发布到Stellar Registry
从注册表部署已发布的合约
为已部署的合约创建别名
查询已发布合同和版本的注册表

代币合约插件 （15个工具）：

令牌查询操作（名称、符号、余额、容差等）
代币交易操作（转账、造币、销毁、暂停等）

NFT合约插件 （17个工具）：

NFT查询操作（所有者、余额、元数据等）
NFT交易操作（造币、转账、销毁、批准等）

治理契约插件 （3个工具）：

用默克尔证明投票
投票状态检查
投票结果检索

实用程序插件 （15个工具）：

Merkle树生成和验证
配置构建器
地址验证
金额格式
盐生成

总计：80+工具

特性

智能合约部署

代币工厂：部署Pausable、Capped、Allowlist、Blocklist或Vault令牌
NFT工厂：部署枚举或访问控制NFT集合
治理工厂：部署MerkleVoting治理合同
注册表集成：通过Stellar Registry发布和部署合约

令牌操作

代币转移：本地和可替换令牌操作
余额查询：实时账户余额监控
许可证管理：点火、燃烧、暂停功能
审批制度：津贴和授权管理

NFT操作

馆藏管理：完成NFT生命周期操作
元数据处理：令牌URI和元数据管理
转移操作：所有权转移安全
审批制度：个人和运营商批准

治理运营

默克尔投票：隐私保护投票
投票跟踪：实时投票状态和结果
证明生成：自动创建防闪烁效果

注册表操作

合同出版：将编译的WASM发布到注册表
版本管理：跟踪和部署特定版本
Alias系统：创建对合同的命名引用
发现：列出并查询已发布的合同

工具函数

Merkle树：生成带有证明的完整默克尔树
验证：地址和配置验证
建筑商：常见模式的快速配置构建器
格式化：人工和合同格式之间的金额转换

快速开始

先决条件

支持MCP的Claude桌面、光标或VS代码
Node.js 18或更高版本
pnpm包管理器
有资金余额的恒星账户（测试网或主网）

安装

克隆并构建服务器

   cd stellar-studio-mcp-server
   pnpm install
   pnpm build

配置环境变量

   cp .env.testnet .env
   # Edit .env with your Stellar secret key

生成恒星密钥：

   stellar keys generate my-key
   stellar keys show my-key

自动设置（推荐）

使用自动设置脚本配置您首选的AI应用程序：

   # Interactive mode - choose which application to configure
   pnpm setup:claude

   # Or configure specific applications
   pnpm setup:cursor    # Configure Cursor editor
   pnpm setup:code      # Configure VS Code

   # Or use the script directly for multiple applications
   ./setup-mcp.sh --claude --cursor

安装脚本将：

- 阅读你的 .env 配置 - 生成适当的MCP配置 - 将其安装在所选应用程序的正确位置 - 提供重启说明

手动配置（备选）

如果您喜欢手动设置，可以直接配置应用程序：

克劳德桌面: ~/Library/Application Support/Claude/claude_desktop_config.json

光标编辑器: ~/.cursor/mcp.json

VS Code: ~/Library/Application Support/Code/User/mcp.json

配置示例：

   {
     "mcpServers": {
       "stellar-studio": {
         "command": "node",
         "args": ["/absolute/path/to/stellar-studio-mcp-server/dist/index.js"],
         "env": {
           "STELLAR_SECRET_KEY": "SD...",
           "STELLAR_NETWORK": "testnet"
         }
       }
     }
   }

重新启动AI应用程序

关闭并重新打开Claude Desktop、Cursor或VS Code以加载MCP服务器。

环境配置

变量	必填	描述
`STELLAR_SECRET_KEY`	是	您的恒星密钥（以SD开头）
`STELLAR_NETWORK`	是	网络： `local`, `testnet`，或 `mainnet`
`TOKEN_FACTORY`	自动	令牌工厂合约地址（自动配置）
`NFT_FACTORY`	自动	NFT工厂合同地址（自动配置）
`GOVERNANCE_FACTORY`	自动	治理工厂合同地址（自动配置）

工厂地址（测试网）：

TOKEN_FACTORY=CAHLJEQUCNTV7JPAPCMLCBIHOX7FFB57DUARJ6XGTW27FPCVKKY7JM2A
NFT_FACTORY=CDJQAGTVOK37NPBWMADBJDGFYM6BEAFV4T45S23D4LQLGSTMRRZ5RQ6X
GOVERNANCE_FACTORY=CC3SLHSCJHP7YJ462ZIACJ54VOHL5ZFUODZKBTITIZSO74D4YOPR5WCE

网络交换

# Switch to testnet
cp .env.testnet .env
pnpm build
./setup-mcp.sh --claude

# Switch to local development
cp .env.local .env
pnpm build
./setup-mcp.sh --claude

用法示例

令牌操作

"Deploy a new token named MyToken with symbol MTK and 1 million initial supply"
"Get the balance of my MTK tokens"
"Transfer 1000 MTK tokens to GA2C..."
"Mint 50000 MTK tokens to my address"
"Get all deployed tokens from the factory"
"Show me all Pausable tokens"

NFT操作

"Deploy a new NFT collection called CoolNFTs with symbol COOL"
"Mint an NFT in my collection at CA..."
"Transfer NFT #5 from my collection to GB..."
"Get all my NFTs"
"Show me all NFT collections I own"

治理运营

"Deploy a governance contract with voters: GA..., GB..., GC..."
"Cast a vote for proposal with my merkle proof"
"Check if address GA... has voted"
"Get the current vote results"

注册表操作

"Publish my compiled token contract to the registry"
"Deploy version 1.0.0 of my-token from the registry"
"Create an alias for my deployed contract"
"Show me all published contracts"
"Get the current version of my-token contract"

公用事业运营

"Generate a merkle tree for addresses: GA..., GB..., GC..."
"Validate this Stellar address: GA..."
"Generate a random salt for deployment"
"Format 100 tokens with 7 decimals"
"Build a token configuration for a capped token"

工具参考

完整工具清单

工厂工具（1）：

factory_get_deployed -获取所有已部署的工厂合同

令牌部署和查询（5）：

token_deploy -通过TokenFactory部署新令牌
token_get_deployed -列出所有已部署的令牌
token_get_by_type -按类型过滤令牌（Pausable、Capped等）
token_get_by_admin -按管理员地址筛选令牌
token_get_count -获取令牌部署总数

NFT部署和查询（5）：

nft_deploy -通过NFTFactory部署新的NFT集合
nft_get_deployed -列出所有已部署的NFT集合
nft_get_by_type -按类型过滤NFT（枚举、访问控制）
nft_get_by_owner -按所有者地址筛选NFT
nft_get_count -获取NFT部署总数

治理部署和查询（5）：

governance_deploy -通过GovernanceFactory部署治理契约
governance_get_deployed -列出所有已部署的治理合同
governance_get_by_type -按类型过滤治理（MerkleVoting）
governance_get_by_admin -按管理员地址筛选治理
governance_get_count -获取治理部署总数

注册表工具（6）：

registry_publish -将编译好的合约发布到Stellar Registry
registry_deploy -从注册表部署已发布的合约
registry_create_alias -为已部署的合约创建别名
registry_list_published -列出所有已发布的合同（注：支持有限）
registry_get_versions -获取合同的当前版本
registry_info -获取特定已发布合同的信息

代币合约操作（15）：

查询（7个工具）： 名称、符号、小数、总供应量、余额、容差、暂停
交易（8种工具）： transfer、transfer_from、approve、mint、burn、burn_from、暂停、取消暂停

NFT合同操作（17）：

查询（10个工具）： 名称、符号、余额、所有者\_ of、获得批准、全部获得批准、token_uri、总供应、获得所有者\_ token_id、获得令牌_id
交易（7种工具）： mint、transfer、transfer_from、approve、approve_for_all、burn、burn_from

治理合同操作（3）：

governance_contract_vote -投票不受干扰
governance_contract_has_voted -检查地址是否已投票
governance_contract_get_vote_results -获取投票结果

实用工具（15）：

默克尔： createMerkleRoot, buildMerkleTree
验证： validateAddress, validateTokenConfig, validateGovernanceConfig
建筑商： buildTokenConfig, buildNFTConfig, buildGovernanceConfig, buildMerkleVoting, buildCappedToken, buildSimpleToken, buildMultisig
格式： formatTokenAmount, parseTokenAmount
世代： generateSalt, generateMultipleSalts

发展

项目结构

stellar-studio-mcp-server/
├── src/
│   ├── core/                        # MCP core functionality
│   │   ├── Tool.decorator.ts        # @Tool decorator
│   │   ├── Option.ts                # Stellar Option type helpers
│   │   └── WalletClientBase.ts      # Base wallet client
│   │
│   ├── clients/                     # Contract client wrappers
│   │   ├── TokenFactoryClient.ts
│   │   ├── NFTFactoryClient.ts
│   │   ├── GovernanceFactoryClient.ts
│   │   └── RegistryClient.ts
│   │
│   ├── plugins/                     # Tool plugins
│   │   ├── factory/                 # Factory tracking
│   │   ├── token/                   # Token deployment
│   │   ├── nft/                     # NFT deployment
│   │   ├── governance/              # Governance deployment
│   │   ├── registry/                # Registry operations
│   │   ├── token-contract/          # Token contract operations
│   │   ├── nft-contract/            # NFT contract operations
│   │   ├── governance-contract/     # Governance contract operations
│   │   └── utilities/               # Utility tools
│   │
│   ├── utils/                       # Shared utilities
│   │   ├── merkle.ts                # Merkle tree generation
│   │   ├── validation.ts            # Parameter validation
│   │   ├── builders.ts              # Configuration builders
│   │   └── salt.ts                  # Salt generation
│   │
│   ├── registry/                    # Contract address registry
│   │   └── addresses.ts             # Network-specific addresses
│   │
│   └── index.ts                     # MCP server entry point
│
├── packages/                        # Generated Stellar SDK packages
│   ├── token_factory/
│   ├── nft_factory/
│   ├── governance_factory/
│   └── .../
│
├── dist/                            # Built output
├── setup-mcp.sh                     # Automated setup script
├── .env.testnet                     # Testnet configuration template
├── .env.local                       # Local network configuration template
├── tsconfig.json                    # TypeScript configuration
└── tsup.config.ts                   # Build configuration

添加新工具

// 1. Create service class in src/plugins/my-plugin/
export class MyService {
  @Tool({
    name: 'my_operation',
    description: 'Performs custom operation'
  })
  async myOperation(
    client: StellarClient,
    params: MyParams
  ): Promise {
    // Implementation
    return {
      success: true,
      data: result,
      suggestion: 'Operation completed successfully'
    };
  }
}

// 2. Register in src/index.ts
import { MyService } from './plugins/my-plugin/my.service';
server.registerTools(new MyService());

建筑

# Development build with watch
pnpm dev

# Production build
pnpm build

# Type checking
pnpm typecheck

# Start server
pnpm start

测试

自动设置测试

# Test setup for Claude Desktop
pnpm setup:claude

# Test setup for Cursor
pnpm setup:cursor

# Test setup for VS Code
pnpm setup:code

# Or use the script directly
./setup-mcp.sh --help

手动测试

# Build the server
pnpm build

# Test with Claude Desktop
# Tools should appear automatically after restart

# Test specific tool by asking:
# "Deploy a test token named TestToken with symbol TST"

测试状态

所有80多个MCP工具都已在Stellar测试网上实施和测试，包括：

✅ 工厂部署跟踪
✅ 令牌部署和查询
✅ NFT部署和查询
✅ 治理部署和查询
✅ 注册表发布和部署
✅ 代币合约操作（15个工具）
✅ NFT合同操作（17个工具）
✅ 治理合同操作（3个工具）
✅ 实用功能（15个工具）

安全考虑

钱包安全

使用环境变量安全地存储密钥
从不将凭据提交到版本控制
使用测试网进行开发和测试
执行前验证所有交易详细信息

网络安全

使用官方RPC端点进行区块链连接
交互前验证智能合约地址
监控交易费用和网络拥塞
实施适当的错误处理和日志记录

交易安全

提交前模拟所有交易
用户必须使用钱包密钥进行授权
执行前的参数验证
地址格式验证

集成API

恒星SDK

核心区块链操作使用官方Stellar JavaScript SDK，支持Soroban智能合约、交易创建、签名和广播。

生成的合同客户

TypeScript客户端由Soroban合约自动生成，使用 stellar contract bindings typescript，提供类型安全的合约交互。

模型上下文协议

标准化的AI到工具集成协议，实现了跨多个AI客户端与区块链操作的自然语言交互。

故障排除

常见问题

工具未出现在AI客户端中

配置更改后重新启动AI应用程序
验证MCP配置文件中的绝对路径
检查服务器是否已成功构建(pnpm build)
验证环境变量是否设置正确

地址格式错误无效

确保Stellar地址以G（帐户）或C（合约）开头
使用正确的网络地址格式（测试网vs主网）
验证地址是否适用于正确的网络

余额不足错误

检查XLM余额以了解交易费用
转账前验证代币余额
考虑网络拥塞对费用的影响

网络连接问题

验证RPC端点可访问性
检查中的网络配置 .env
测试备选网络端点
确保选择了正确的网络（本地/测试网/主网）

安装脚本错误

确保 .env 文件在运行安装程序之前已存在
验证项目是否已构建(pnpm build)
检查Node.js是否在PATH中
与一起跑步 --help 使用信息标志

调试模式

启用详细日志记录：

export DEBUG=true
pnpm dev

其他资源

文档：

合同_活动_规格.md -详细的工具规格
主存储库README -恒星工作室生态系统概述

相关项目：

恒星工作室合同 -智能合约源代码
恒星工作室前端 -Web界面（即将推出）

外部链接：

模型上下文协议 -MCP规范
恒星SDK -JavaScript SDK文档
索罗班文件 -智能合约指南
恒星实验室 -网络浏览器和测试工具

贡献

该项目展示了人工智能区块链集成模式，欢迎贡献。请遵循以下指南：

分叉存储库并创建功能分支
遵循TypeScript编码标准和惯例
为新功能添加全面的测试
更新API变更文档
提交带有详细描述的拉取请求

许可证

MIT许可证-请参阅许可证提交完整的条款和条件。

______________________________________________________________________

Stellar Studio MCP服务器 -通过自然语言交互将人工智能与Stellar区块链连接起来。

使用TypeScript、MCP和Stellar SDK为Soroban智能合约构建。

Stellar Studio MCP

快速接入

详细介绍