内容
# 📚 IQ Wiki MCP 服务器
[](https://www.npmjs.com/package/@iqai/mcp-iqwiki)
[](https://opensource.org/licenses/MIT)
## 📖 概述
IQ Wiki MCP 服务器使 AI 代理能够与 [IQ.wiki](https://iq.wiki) 互动，这是一个用于加密货币和 DeFi 知识的区块链驱动的百科全书。该服务器提供对 wiki 数据、用户贡献和活动跟踪的全面访问。
通过实施模型上下文协议（MCP），该服务器允许大型语言模型（LLM）直接通过其上下文窗口发现 wiki 文章、搜索知识和跟踪用户 wiki 活动，弥合了 AI 和去中心化知识之间的差距。
## ✨ 功能
* **Wiki 访问**：通过 ID 检索 IQ.wiki 上任意 wiki 文章的详细信息。
* **用户贡献**：根据以太坊地址跟踪特定用户创建或编辑的 wiki。
* **活动跟踪**：监控详细的 wiki 活动（创建和编辑），可选时间过滤。
* **搜索**：使用自然语言查询搜索 wiki 文章。
## 📦 安装
### 🚀 使用 npx（推荐）
无需全局安装即可使用此服务器：
```bash
npx @iqai/mcp-iqwiki
```
### 📦 使用 pnpm dlx
```bash
pnpm dlx @iqai/mcp-iqwiki
```
### 🔧 从源代码构建
```bash
git clone https://github.com/IQAIcom/mcp-iqwiki.git
cd mcp-iqwiki
pnpm install
pnpm run build
```
## ⚡ 使用 MCP 客户端运行
在您的 MCP 客户端设置中添加以下配置（例如 `claude_desktop_config.json`）。
### 📋 最小配置
```json
{
"mcpServers": {
"iq-wiki": {
"command": "npx",
"args": ["-y", "@iqai/mcp-iqwiki"]
}
}
}
```
### ⚙️ 高级配置（本地构建）
```json
{
"mcpServers": {
"iq-wiki": {
"command": "node",
"args": ["/absolute/path/to/mcp-iqwiki/dist/index.js"]
}
}
}
```
## 💡 使用示例
### 🔍 Wiki 发现
* "获取比特币的 wiki 文章"
* "搜索关于 DeFi 协议的 wiki"
* "查找有关以太坊的信息"
### 👤 用户贡献
* "0x8AF7a19a26d8FBC48dEfB35AEfb15Ec8c407f889 创建了哪些 wiki？"
* "显示用户在过去 24 小时内编辑的 wiki"
* "获取此以太坊地址的所有 wiki 活动"
### 📊 活动跟踪
* "列出用户 0x... 最近创建的 wiki"
* "显示过去一小时内的 wiki 编辑"
* "跟踪用户 wiki 贡献随时间的变化"
## 🛠️ MCP 工具
<!-- AUTO-GENERATED TOOLS START -->
### `GET_USER_CREATED_WIKIS`
获取 IQ.wiki 上特定用户创建的 wiki
| 参数 | 类型 | 必需 | 描述 |
|-----------|------|----------|-------------|
| `id` | 字符串 | ✅ | 用户的以太坊地址 |
| `timeFrameSeconds` | 数字 | | 可选的时间范围（秒）用于筛选结果 |
### `GET_USER_EDITED_WIKIS`
获取 IQ.wiki 上特定用户编辑的 wiki
| 参数 | 类型 | 必需 | 描述 |
|-----------|------|----------|-------------|
| `id` | 字符串 | ✅ | 用户的以太坊地址 |
| `timeFrameSeconds` | 数字 | | 可选的时间范围（秒）用于筛选结果 |
### `GET_USER_WIKI_ACTIVITIES`
获取 IQ.wiki 上特定用户的 wiki 活动（创建或编辑）
| 参数 | 类型 | 必需 | 描述 |
|-----------|------|----------|-------------|
| `id` | 字符串 | ✅ | 用户的以太坊地址 |
| `activityType` | 字符串 | | 活动类型：CREATED 或 UPDATED |
| `timeFrameSeconds` | 数字 | | 可选的时间范围（秒）用于筛选结果 |
### `GET_WIKI`
获取 IQ.wiki 上特定 wiki 的详细信息，ID
| 参数 | 类型 | 必需 | 描述 |
|-----------|------|----------|-------------|
| `id` | 字符串 | ✅ | 要检索的 wiki 的 ID |
### `SEARCH_WIKI`
通过查询在 IQ.wiki 上搜索 wiki
| 参数 | 类型 | 必需 | 描述 |
|-----------|------|----------|-------------|
| `query` | 字符串 | ✅ | 要搜索的查询 |
<!-- AUTO-GENERATED TOOLS END -->
## 👨💻 开发
### 🏗️ 构建项目
```bash
pnpm run build
```
### 👁️ 开发模式（监视）
```bash
pnpm run watch
```
### ✅ linting 和格式化
```bash
pnpm run lint
pnpm run format
```
### 🧪 测试
```bash
pnpm test
```
### 📁 项目结构
* `src/tools/`：单个工具定义
* `src/services/`：API 客户端和业务逻辑
* `src/lib/`：共享实用程序
* `src/index.ts`：服务器入口点
## 📚 资源
* [IQ.wiki 平台](https://iq.wiki)
* [模型上下文协议（MCP）](https://modelcontextprotocol.io)
* [IQ.wiki 文档](https://learn.iq.wiki)
## ⚠️ 免责声明
此工具与 IQ.wiki 区块链数据交互。用户应独立验证所有信息。Wiki 内容由社区贡献，可能会随时间变化。
## 📄 许可证
[MIT](LICENSE)
