- Explore MCP Servers
- mcp-iqwiki
Mcp Iqwiki
What is Mcp Iqwiki
mcp-iqwiki is a minimal starter template designed for building Model Context Protocol (MCP) servers using TypeScript and FastMCP. It provides a structured approach to developing MCP applications.
Use cases
Use cases for mcp-iqwiki include creating weather services that integrate with external APIs, developing custom tools for data validation and processing, and building scalable server applications that adhere to the Model Context Protocol.
How to use
To use mcp-iqwiki, create a new repository from the template, navigate to your project directory, initialize a Git repository, customize the package.json, install dependencies, configure environment variables, and begin developing your server by adding custom tools and implementing logic.
Key features
Key features of mcp-iqwiki include a basic project structure, TypeScript setup, linting and formatting with Biome, MCP server implementation using fastmcp, a weather service example demonstrating API integration and error handling, and GitHub Actions workflows for CI and Release.
Where to use
mcp-iqwiki can be used in various fields that require server-side applications, particularly those needing structured API development, such as weather services, data processing, and other web services.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Overview
What is Mcp Iqwiki
mcp-iqwiki is a minimal starter template designed for building Model Context Protocol (MCP) servers using TypeScript and FastMCP. It provides a structured approach to developing MCP applications.
Use cases
Use cases for mcp-iqwiki include creating weather services that integrate with external APIs, developing custom tools for data validation and processing, and building scalable server applications that adhere to the Model Context Protocol.
How to use
To use mcp-iqwiki, create a new repository from the template, navigate to your project directory, initialize a Git repository, customize the package.json, install dependencies, configure environment variables, and begin developing your server by adding custom tools and implementing logic.
Key features
Key features of mcp-iqwiki include a basic project structure, TypeScript setup, linting and formatting with Biome, MCP server implementation using fastmcp, a weather service example demonstrating API integration and error handling, and GitHub Actions workflows for CI and Release.
Where to use
mcp-iqwiki can be used in various fields that require server-side applications, particularly those needing structured API development, such as weather services, data processing, and other web services.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Content
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.
pnpm dlx @iqai/mcp-iqwiki
2. Global Installation from npm (via pnpm):
Install the package globally to make the mcp-iqwiki
command available system-wide:
pnpm add -g @iqai/mcp-iqwiki
3. Building from Source (for development or custom modifications):
-
Clone the repository:
git clone https://github.com/IQAIcom/mcp-iqwiki.git cd mcp-iqwiki
-
Install dependencies:
pnpm install
-
Build the server:
This compiles the TypeScript code to JavaScript in thedist
directory.pnpm run build
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):
{
"mcpServers": {
"iq-wiki-mcp-server": {
"command": "pnpm",
"args": [
"dlx",
"@iqai/mcp-iqwiki"
]
}
}
}
Alternative if Globally Installed:
If you have installed mcp-iqwiki
globally, you can simplify the command:
{
"mcpServers": {
"iq-wiki-mcp-server": {
"command": "mcp-iqwiki",
"args": []
}
}
}
Tool Examples
Below are examples of how to use each tool in this MCP server:
GET_WIKI
{
"id": "bitcoin"
}
GET_USER_CREATED_WIKIS
{
"id": "0x8AF7a19a26d8FBC48dEfB35AEfb15Ec8c407f889",
"timeFrameSeconds": 3600
}
GET_USER_EDITED_WIKIS
{
"id": "0x8AF7a19a26d8FBC48dEfB35AEfb15Ec8c407f889"
}
GET_USER_WIKI_ACTIVITIES
{
"id": "0x8AF7a19a26d8FBC48dEfB35AEfb15Ec8c407f889",
"activityType": "CREATED",
"timeFrameSeconds": 86400
}
Dev Tools Supporting MCP
The following are the main code editors that support the Model Context Protocol. Click the link to visit the official website for more information.