MCP Tools Guide Tools

Learn how to use MCP tools for extended AI capabilities.

What is MCP?

MCP (Model Context Protocol) is an open standard that enables AI to use external tools and data sources.

Built-in Tools

ChatAI Plugin includes built-in tools in 22 categories. See Built-in Tools for the full list.

Category	Description	Category	Description
basic	Time, random numbers	search	Web search, Wiki, translation
user	User info, friends	utils	Calculation, encoding
group	Group info, members	voice	TTS, voice recognition
message	Send/get messages	bot	Bot info, status
admin	Mute, kick, admin	extra	Weather, quotes, dice
media	Images, QR codes	schedule	Scheduled tasks
web	Fetch web pages	bltools	QQ Music, Bilibili, GitHub
memory	User memory CRUD	imageGen	AI image generation
file	File upload/download	qzone	QQ Zone moments

Using Tools

AI automatically uses tools when needed:

User: What time is it?
AI: [calls get_current_time] It's 2:30 PM.

User: Search for weather in Tokyo
AI: [calls web_search] Here's the weather forecast...

Viewing Tool Calls

See what tools AI used:

#工具日志

Enable debug mode for detailed logs:

#ai调试开启

Tool Permissions

Tools have different permission levels:

Level	Who Can Use	Examples
🟢 Safe	Everyone	Time, search
🟡 Medium	Members	Send messages
🟠 Higher	Admins	Group management
🔴 Dangerous	Masters only	Shell commands

Managing Tools

Via Web Panel

1. Go to Tools tab
2. Enable/disable categories
3. Configure permissions

Via Config

builtinTools:
  enabledCategories:
    - basic
    - user
    - search
  disabledCategories:
    - shell
    - admin

External MCP Servers

Add more tools via external MCP servers:

// data/mcp-servers.json
{
  "servers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-filesystem"]
    }
  }
}

Popular servers:

• @anthropic/mcp-server-filesystem - File operations
• @anthropic/mcp-server-fetch - Web fetching
• @anthropic/mcp-server-github - GitHub API

Custom Tools

Create your own tools in data/tools/:

// data/tools/my_tool.js
export const tools = [{
  name: 'my_tool',
  description: 'My custom tool',
  handler: async (args) => {
    return { result: 'Done!' }
  }
}]

MCP Status

Check MCP server status:

#mcp状态

Next Steps

• Tool Development - Create custom tools
• MCP Configuration - Advanced MCP config