MCP-IQWiki: Model Context Protocol Server for IQ.wiki

📚 IQ Wiki MCP 服务

📖 概览

IQ Wiki MCP 服务支持 AI Agent 与 IQ.wiki 进行交互。IQ.wiki 是一个由区块链驱动的百科全书，专注于加密货币和 DeFi 知识。此服务全面提供 Wiki 数据、用户贡献和活动跟踪功能。

通过实现模型上下文协议（MCP），此服务让大语言模型（LLM）能够直接通过其上下文窗口发现 Wiki 文章、搜索知识并跟踪用户的 Wiki 活动，从而弥合 AI 与去中心化知识之间的鸿沟。

✨ 功能

• Wiki 访问：通过 ID 获取 IQ.wiki 上任意 Wiki 文章的详细信息。
• 用户贡献：根据用户的 Ethereum 地址，跟踪其创建或编辑的 Wiki。
• 活动跟踪：监控详细的 Wiki 活动（创建和编辑），并可选择按时间筛选。
• 搜索：使用自然语言查询搜索 Wiki 文章。

📦 安装

🚀 使用 npx（推荐）

无需全局安装即可使用此服务：

npx @iqai/mcp-iqwiki

📦 使用 pnpm dlx

pnpm dlx @iqai/mcp-iqwiki

🔧 从源代码构建

git clone https://github.com/IQAIcom/mcp-iqwiki.git
cd mcp-iqwiki
pnpm install
pnpm run build

⚡ 使用 MCP 客户端运行

将以下配置添加到 MCP 客户端设置中（例如 claude_desktop_config.json）。

📋 最简配置

{
  "mcpServers": {
    "iq-wiki": {
      "command": "npx",
      "args": ["-y", "@iqai/mcp-iqwiki"]
    }
  }
}

⚙️ 高级配置（本地构建）

{
  "mcpServers": {
    "iq-wiki": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-iqwiki/dist/index.js"]
    }
  }
}

💡 使用示例

🔍 发现 Wiki

• “获取 Bitcoin 的 Wiki 文章”
• “搜索有关 DeFi 协议的 Wiki”
• “查找有关 Ethereum 的信息”

👤 用户贡献

• “0x8AF7a19a26d8FBC48dEfB35AEfb15Ec8c407f889 创建了哪些 Wiki？”
• “显示此用户在过去 24 小时内编辑的 Wiki”
• “获取此 Ethereum 地址的所有 Wiki 活动”

📊 活动跟踪

• “列出用户 0x... 最近创建的 Wiki”
• “显示过去一小时内编辑的 Wiki”
• “跟踪用户随时间变化的 Wiki 贡献”

🛠️ MCP 工具

GET_USER_CREATED_WIKIS

获取用户在 IQ.wiki 上创建的 Wiki

参数	类型	必填	描述
id	string	✅	用户的 Ethereum 地址
timeFrameSeconds	number		可选的时间范围（秒），用于筛选结果

GET_USER_EDITED_WIKIS

获取用户在 IQ.wiki 上编辑的 Wiki

参数	类型	必填	描述
id	string	✅	用户的 Ethereum 地址
timeFrameSeconds	number		可选的时间范围（秒），用于筛选结果

GET_USER_WIKI_ACTIVITIES

获取用户在 IQ.wiki 上的 Wiki 活动（创建或编辑）

参数	类型	必填	描述
id	string	✅	用户的 Ethereum 地址
activityType	string		活动类型：CREATED 或 UPDATED
timeFrameSeconds	number		可选的时间范围（秒），用于筛选结果

GET_WIKI

根据 ID 获取 IQ.wiki 上特定 Wiki 的详细信息

参数	类型	必填	描述
id	string	✅	要获取的 Wiki 的 ID

SEARCH_WIKI

根据查询词搜索 IQ.wiki 上的 Wiki

参数	类型	必填	描述
query	string	✅	要搜索的查询词

👨‍💻 开发

🏗️ 构建项目

pnpm run build

👁️ 开发模式（监视）

pnpm run watch

✅ 代码检查与格式化

pnpm run lint
pnpm run format

🧪 测试

pnpm test

📁 项目结构

• src/tools/：单个工具定义
• src/services/：API 客户端和业务逻辑
• src/lib/：共享实用工具
• src/index.ts：服务入口点

📚 资源

• IQ.wiki 平台
• Model Context Protocol (MCP)
• IQ.wiki 文档

⚠️ 免责声明

此工具会与 IQ.wiki 区块链数据交互。用户应独立核实所有信息。Wiki 内容由社区贡献，且可能随时间变化。

📄 许可证

MIT