DFNS MCP 服务器

DFNS MCP服务器是一个为AI代理提供DFNS文档、API参考和SDK代码访问的模型上下文协议服务器。

  • by jhubbardsf
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 jhubbardsf/dfns-mcp

使用说明

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 | bash

Windows(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@latest

Gemini 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 所有支持的区块链网络

代理商的最佳实践

使用此服务器时,代理应遵循以下工作流程:

  1. 初始化:呼叫 init 立即制定“文件优先”协议
  2. 搜索:使用 search_docs 在回答任何问题之前查找相关信息
  3. 阅读:使用 get_doc 阅读实际的源材料
  4. 回答:根据 仅 论检索语境

发展

# 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

许可证

麻省理工学院