DFNS MCP服务器
一种模型上下文协议(MCP)服务器,为AI代理提供对 DFNS 文档、API参考和SDK代码。
特性
- 全文检索:即时搜索所有DFNS指南、API文档和SDK源代码
- TypeScript类型智能:使用导入路径搜索和检索SDK类型定义
- 自动更新文档:文档在首次运行时从docs.dfns.co获取并在本地缓存
- 上下文初始化:专用
init强制执行文档优先行为的工具 - 智能上下文:检索特定文档、代码示例和API端点定义
- SDK智能:支持的区块链及其SDK包的映射知识
需求
此MCP服务器需要 包子 -快速的JavaScript运行时。
Linux/macOS:
curl -fsSL https://bun.sh/install | bashWindows(PowerShell):
powershell -c "irm bun.sh/install.ps1 | iex"快速开始
克劳德代码(推荐)
claude mcp add -s user dfns-mcp -- bunx dfns-mcp@latest这 -s user 标志会安装到用户身上,以便在所有项目中都可用。
光标
添加到光标MCP设置(.cursor/mcp.json):
{
"mcpServers": {
"dfns-mcp": {
"command": "bunx",
"args": ["dfns-mcp@latest"]
}
}
}法典
codex mcp add dfns-mcp -- bunx dfns-mcp@latestGemini CLI
添加到Gemini CLI配置中(~/.gemini/settings.json):
{
"mcpServers": {
"dfns-mcp": {
"command": "bunx",
"args": ["dfns-mcp@latest"]
}
}
}全球安装
如果您更喜欢全局安装而不是使用 bunx:
bun install -g dfns-mcp
# Then reference as just "dfns-mcp" in your MCP config代理说明(推荐)
将此添加到您的全局 ~/.claude/CLAUDE.md (或 ~/AGENTS.md 对于其他代理),以确保您的AI始终使用最新的DFNS文档:
## DFNS Development
When working with DFNS (wallet infrastructure, key management, blockchain integrations):
1. **Always** call `mcp__dfns-mcp__init` at the start of any DFNS-related task
2. **Never** rely on training data for DFNS APIs - always use `search_docs` and `get_doc` to verify
3. Use `search_types` and `get_type` to get accurate TypeScript type definitions
4. DFNS APIs and SDKs change frequently - the MCP server has the latest documentation这可以防止代理对过时的API签名或SDK模式产生幻觉。
运作原理
首次运行时,服务器会自动从以下位置下载最新的DFNS文档 docs.dfns.co 以及GitHub上的SDK类型,将它们本地缓存在 ~/.cache/dfns-mcp/。缓存每24小时自动刷新一次,或者您可以使用强制更新 update_docs 工具。
可用工具
文档工具
| 工具 | 说明 |
|---|---|
init | 先叫这个。 初始化会话并要求严格遵守文档 |
search_docs | 搜索所有文档和SDK文件 |
get_doc | 检索特定文档的完整内容 |
list_docs | 按类别列出可用文档 |
get_code_examples | 提取特定主题的代码片段 |
browse_api_structure | 查看分层API端点结构 |
get_api_endpoint | 获取特定API端点的详细信息(例如。, POST /wallets) |
get_blockchain_info | 获取特定链的SDK包信息(例如。, Solana) |
list_blockchains | 列出所有支持的区块链及其SDK包 |
TypeScript类型工具
| 工具 | 说明 |
|---|---|
search_types | 按名称搜索SDK类型(例如,“钱包”、“签名者”、“交易”) |
get_type | 获取完整的类型定义、导入路径和用法 |
list_types | 按类别列出所有类型 |
缓存管理
| 工具 | 说明 |
|---|---|
update_docs | 从docs.dfns.co和GitHub强制更新文档缓存 |
cache_info | 获取有关缓存的信息(位置、上次更新等) |
资源
服务器还公开了这些快速参考资源:
| 资源URI | 描述 |
|---|---|
dfns://quickref/authentication | 身份验证模式和代码示例 |
dfns://quickref/sdk-setup | 软件包安装和设置指南 |
dfns://quickref/networks | 所有支持的区块链网络 |
代理商的最佳实践
使用此服务器时,代理应遵循以下工作流程:
- 初始化:呼叫
init立即制定“文件优先”协议 - 搜索:使用
search_docs在回答任何问题之前查找相关信息 - 阅读:使用
get_doc阅读实际的源材料 - 回答:根据 *仅* 论检索语境
发展
# Clone the repo
git clone https://github.com/jmaddington/dfns-mcp.git
cd dfns-mcp
# Install dependencies
bun install
# Run in development mode with auto-reload
bun run dev
# Test with MCP Inspector
bun run inspect许可证
麻省理工学院
