CosmWasm MCP服务器模板
Rust中的MCP服务器，用于包装查询并执行签名者要广播的入口点消息。此项目模板应适用于任何CosmWasm合同。
构建此项目
要构建此项目，需要 nightly Rust的构建，这将允许使用rustc的2024版。
# Switch rustc to `nightly` channel
rustup default nightly# Build for development
cargo build# Build for deployment
cargo build --release如何使用
此项目是一个MCP服务器模板，可用于任何CosmWasm合约，但要将此模板用于您自己的合约，您需要进行一些小的更改。
要将此模板用于您自己的合同，请执行以下操作 _强制性的_ 变化：
步骤1-更新Cargo.toml
- 更改中的合同依赖关系
Cargo.toml
删除以下行 Cargo.toml 并将其替换为合同的依赖关系：
cw20-wrap = { git = "https://github.com/archway-network/cw20-wrap.git", version = "1.0.0", features = ["library"] }第二步-确保你的合同可以构建为一个库
- 你 _应该_ 确保您刚才添加到的依赖关系
Cargo.toml不出口cosmwasm_std::entry_point,query和execute.
例如，你的合同应该 _不_ 导入 entry_point, query 和 execute （以此类推 instantiate, reply, migrate等与您的项目相关），如下所示：
use cosmwasm_std::{
entry_point, to_json_binary, Binary, Deps, DepsMut, Env, MessageInfo, Response, StdResult,
Uint128,
};
// ...
pub fn execute(deps: DepsMut, env: Env, info: MessageInfo, msg: ExecuteMsg) -> Result {
// ...
}
pub fn query(deps: Deps, _env: Env, msg: QueryMsg) -> StdResult {
// ...
}相反，你应该像这样展示你的合同入口点：
#[cfg(not(feature = "library"))]
use cosmwasm_std::entry_point;
use cosmwasm_std::{
to_json_binary, Binary, Deps, DepsMut, Env, MessageInfo, Response, StdResult,
Uint128,
};
#[cfg_attr(not(feature = "library"), entry_point)]
pub fn execute(deps: DepsMut, env: Env, info: MessageInfo, msg: ExecuteMsg) -> Result {
// ...
}
#[cfg_attr(not(feature = "library"), entry_point)]
pub fn query(deps: Deps, _env: Env, msg: QueryMsg) -> StdResult {
// ...
}步骤3-更新server.rs
- 更改中的合同依赖关系
src/server.rs
/// Replace the below import with the contract you want the MCP server to support
use cw20_wrap::msg::{ExecuteMsg, QueryMsg};步骤4-更新contract.rs中已部署的合约地址
/// Replace with your deployed contract addresses.
/// This helps the query msg and tx msg builders wrap
/// your query and tx messages to the contract into
/// CosmWasm's `QueryRequest` and `CosmosMessage` types
/// that can be broadcast by a rpc enabled wallet tool
pub static CONTRACT_MAINNET: &str =
"archway1gaf9nw7n8v5lpjz9caxjpps006kxfcrzcuc8y5qp4clslhven2ns2g0ule";
pub static CONTRACT_TESTNET: &str =
"archway1r8kepegwhldwqanuurc769l2g0qxlsm2sm6t5rhqjzcerxsgshls267f7a";步骤5（可选）-为任何自定义类型启用MCP工具
- 如果你的合同使用了你认为对人工智能代理应该访问有益的任何自定义类型或响应，那么有一个例子（注释掉了） server.rs 如何实现这一点（见下面的摘录
src/server.rs).
/// (Optionally) if your contract provides any custom query response types
/// configure this tool so the MCP agent can access them. Allowing the MCP
/// agent to access the custom query responses enables it to provide smarter
/// advice, and summaries, about exacly what data can be fetched when making
/// a query to the contract.
/// @see: src/query.rs
#[tool(description = LIST_QUERY_RESPONSE_DESCR)]
async fn list_query_responses(&self) -> Result {
let schema = schema_for!(AllQueryResponse);
let serialized: String = serde_json::to_string(&schema).unwrap_or("".to_string());
Ok(CallToolResult::success(vec![Content::text(serialized)]))
}步骤6（可选）-自定义LLM指令
- 系统提示上下文的所有服务器指令和工具描述都位于
src/instruction.rs. - 内容
src/instruction.rs这些都是基本的工作示例。当处理复杂的合约和/或多合约系统时，您可能需要改进工具和服务器描述，为LLM提供更详细的上下文。
步骤7（可选）-设置MCP服务器传输模式
- 此模板支持3种传输模式：stdio、sse和http流式传输
- 此模板默认为stdio传输模式
- 关于运输方式：
- 标准 -服务器将使用系统标准输入/输出进行响应 - SSE -服务器端事件服务器(MDN文档) - http流媒体 -远程MCP服务器的更新标准，提供JSON API服务器功能(Claudemcp文件)
优化AI准确性
在您的文档中添加文档注释对于模式生成很重要
即使在扩展了您的服务器说明、工具描述和工具参数描述后，您也可能会发现AI继续提供不准确或误导性的数据，或者很少提供有关合同切入点的详细信息。通常，这是由于您的合同源代码中缺少文档注释（例如三斜线注释“///”） msg::QueryMsg 和 msg::ExecuteMsg
这是因为 阴谋家 将文档注释作为描述元数据字段直接嵌入到模式中。
这里有一个评论很好的例子 msg::QueryMsg 这将有助于指导LLM代理：
#[derive(Serialize, Deserialize, Clone, Debug, PartialEq, JsonSchema)]
#[serde(rename_all = "snake_case")]
pub enum QueryMsg {
/// Get all swaps (enumerable)
/// Return type: ListResponse
List {
start_after: Option,
limit: Option,
},
/// Get all Collection Offers (enumerable)
/// Return type: ListResponse
ListCollectionOffers {
start_after: Option,
limit: Option,
},
// ...
}上述两种变体 QueryMsg 将在生成的模式中生成以下嵌入式描述，这对需要解释查询入口点的LLM非常有帮助：
[
{
"description": "Get all swaps (enumerable) Return type: ListResponse",
"type": "object",
"required": [
"list"
],
// ...
},
{
"description": "Get all Collection Offers (enumerable) Return type: ListResponse",
"type": "object",
"required": [
"list_collection_offers"
],
// ...
},
]多合同系统
- 有时，构建一个支持多个合约的MCP服务器是有意义的。实现这一目标的战略是直截了当的：
- 为合同命名空格（例如，以避免重复的符号导入）
- 实现模式匹配和工具参数，以在不同合约之间进行切换
- 有关完整的多合约示例，请参阅 救护车MCP服务器
此MCP服务器模板提供的工具
默认情况下，此MCP服务器提供以下6个工具和功能。
list_contract_deployments-列出Ambur核心合约地址（主网和测试网）list_nft_collections-列出Ambur NFT（主网和测试网合约地址、集合名称和集合描述）list_query_entry_points-列出可以对核心Ambur市场合同进行的查询build_query_msg-构建对核心Ambur市场合约的查询，该合约可以通过RPC连接的钱包进行广播list_tx_entry_points-列出可以对核心Ambur市场合同进行的交易build_execute_msg-构建一个交易到核心Ambur市场合约，该合约可以由RPC连接的钱包签名和广播
将MCP连接到克劳德桌面
以下说明假设MCP服务器是内置的 stdio 模式（这是为Claude桌面配置最简单的模式）。
构建一个发布二进制文件，并指向mcp服务器 command 走自己的路。无运行参数(args)需要：
// claude_desktop_config.json
{
"mcpServers": {
"ambur": {
"command": "/your-computer-path/cosmwasm-mcp-template/target/release/cosmwasm-mcp-template",
"args": []
}
}
}对于虚拟机设置和WSL用户，请按以下方式执行VM command 并使用run参数(args)指向VM运行二进制文件的位置：
// claude_desktop_config.json
{
"mcpServers": {
"ambur": {
"command": "wsl.exe",
"args": [
"bash",
"-ic",
"/your-vm-path/cosmwasm-mcp-template/target/release/cosmwasm-mcp-template",
]
}
}
}将MCP连接到LangGraph
@langchain/mcp适配器 必须安装在图形项目中。此包将把MCP端点转换为Graph工具。
使用@langchain/mcp适配器
// graph.ts
import { MultiServerMCPClient } from "@langchain/mcp-adapters";
// ...
// Create client and connect to server
const client = new MultiServerMCPClient({
throwOnLoadError: true,
prefixToolNameWithServerName: true,
additionalToolNamePrefix: "mcp",
mcpServers: {
cosmwasm_contract: {
transport: "sse",
url: "http://localhost:8000", // Or, URL + IP of a remote host
useNodeEventSource: true,
reconnect: {
enabled: true,
maxAttempts: 5,
delayMs: 2000,
},
// Or, uncomment to use transport mode `http-streamable`:
// url: "http://localhost:8000",
// headers: {},
// automaticSSEFallback: false
},
},
});
const tools = await client.getTools();
// ...