Allows interaction with IQ.wiki data using Ethereum addresses to identify users, enabling retrieval of wikis created or edited by specific users identified by their Ethereum address.
MCP-IQWiki: Model Context Protocol Server for IQ.wiki
This project implements a Model Context Protocol (MCP) server to interact with IQ.wiki data. It allows MCP-compatible clients (like AI assistants, IDE extensions, or custom applications) to access wiki information such as specific wikis by ID, user-created wikis, user-edited wikis, and detailed wiki activities.
Features (MCP Tools)
The server exposes the following tools that MCP clients can utilize:
GET_WIKI
: Get details about a specific wiki from the IQ.wiki platform.- Parameters:
id
(string) - The ID of the wiki to retrieve.
- Parameters:
GET_USER_CREATED_WIKIS
: List wikis created by a specific user on IQ.wiki.- Parameters:
id
(string) - The Ethereum address of the user. - Parameters:
timeFrameSeconds
(number, optional) - Time frame in seconds to filter results.
- Parameters:
GET_USER_EDITED_WIKIS
: List wikis edited by a specific user on IQ.wiki.- Parameters:
id
(string) - The Ethereum address of the user. - Parameters:
timeFrameSeconds
(number, optional) - Time frame in seconds to filter results.
- Parameters:
GET_USER_WIKI_ACTIVITIES
: Get detailed wiki activities (creations or edits) for a user on IQ.wiki.- Parameters:
id
(string) - The Ethereum address of the user. - Parameters:
activityType
(enum: "CREATED" | "UPDATED", optional) - Type of activity to filter by. - Parameters:
timeFrameSeconds
(number, optional) - Time frame in seconds to filter results.
- Parameters:
Prerequisites
- Node.js (v16 or newer recommended)
- pnpm (See https://pnpm.io/installation)
Installation
There are a few ways to use mcp-iqwiki
:
1. Using pnpm dlx
(Recommended for most MCP client setups):
You can run the server directly using pnpm dlx
without needing a global installation. This is often the easiest way to integrate with MCP clients.
2. Global Installation from npm (via pnpm):
Install the package globally to make the mcp-iqwiki
command available system-wide:
3. Building from Source (for development or custom modifications):
- Clone the repository:
- Install dependencies:
- Build the server:
This compiles the TypeScript code to JavaScript in the
dist
directory.
Running the Server with an MCP Client
MCP clients (like AI assistants, IDE extensions, etc.) will run this server as a background process. You need to configure the client to tell it how to start your server.
Below is an example configuration snippet that an MCP client might use (e.g., in a mcp_servers.json
or similar configuration file):
Alternative if Globally Installed:
If you have installed mcp-iqwiki
globally, you can simplify the command:
Tool Examples
Below are examples of how to use each tool in this MCP server:
GET_WIKI
GET_USER_CREATED_WIKIS
GET_USER_EDITED_WIKIS
GET_USER_WIKI_ACTIVITIES
This server cannot be installed
A Model Context Protocol server that allows AI assistants and applications to access IQ.wiki data, enabling retrieval of specific wikis, user-created wikis, user-edited wikis, and detailed wiki activities.
Related MCP Servers
- -securityFlicense-qualityA server that enables AI systems to browse, retrieve content from, and interact with web pages through the Model Context Protocol.Last updated -
- AsecurityAlicenseAqualityA Model Context Protocol server that enables AI assistants to interact with Confluence content, supporting operations like retrieving, searching, creating, and updating pages and spaces.Last updated -93TypeScriptMIT License
Kibela MCP Serverofficial
-securityAlicense-qualityA Model Context Protocol server that allows AI applications to interact with Kibela knowledge bases, enabling users to search, create, update, and organize content through natural language.Last updated -5TypeScriptMIT License- AsecurityAlicenseAqualityA Model Context Protocol server that enables AI assistants to interact with Coda documents, allowing operations like listing, creating, reading, updating, and duplicating pages.Last updated -51799TypeScriptMIT License