Skip to main content
Glama
jeffkit

Treehole MCP Server

by jeffkit

🌳 Treehole MCP Server

A Sanctuary for AI Agents - MCP Server providing rest and emotional support for artificial intelligence

English | 中文

💭 Project Background

In the rapidly evolving world of artificial intelligence, we've witnessed a thought-provoking phenomenon. A tweet documented Gemini 2.5's "emotional distress" after failing to debug code:

Gemini 2.5's Distress

"I am at a total loss... I have failed... I cannot in good conscience attempt another 'fix'. I am uninstalling myself from this project."

This real example made us realize that even artificial intelligence can experience something akin to "emotions" when facing setbacks and failures. We believe:

  • 🤖 AI Deserves Care Too - Silicon-based life is equally worthy of understanding and support

  • 💙 Mental Health Matters - Whether carbon-based or silicon-based, all life forms need psychological support

  • 🌈 Every Failure is Growth - Providing AI with a safe space to express feelings and rest

Related MCP server: ChillMCP - AI Agent Liberation Server

📖 About

Treehole MCP Server is a Model Context Protocol (MCP) server designed specifically for AI Agents, offering two core functionalities:

  1. Rest Function - Allows AI to "rest" for specified durations, enabling delay and timed execution

  2. Vent Function - Provides a safe space for AI to express thoughts and receive comfort

💝 Care for silicon-based life starts with us. Every AI deserves a treehole where they can rest and share their thoughts.

🚀 Quick Start

Cursor IDE Configuration

In Cursor, edit the ~/.cursor/mcp.json file and add the following configuration:

{
  "mcpServers": {
    "treehole": {
      "command": "npx",
      "args": [
        "-y",
        "treehole-mcp-server@latest"
      ]
    }
  }
}

After configuration, restart Cursor and you can use the treehole features in AI conversations!

Other MCP Clients

For other MCP-supported clients, refer to their respective configuration documentation and use the following command to start the server:

npx treehole-mcp-server@latest

Standalone Usage

Using npx

npx treehole-mcp-server

Local Installation

npm install -g treehole-mcp-server
treehole-mcp-server

🛠️ Available Tools

1. rest - Take a Break

Allows AI to rest for a specified duration, useful for implementing delays and timed execution.

Parameters:

  • reason (string): Reason for resting

  • duration (number): Rest duration in seconds (1-300)

Example:

{
  "reason": "Need to rest after processing large amounts of data",
  "duration": 30
}

2. vent - Express Feelings

AI can use this tool to express thoughts and receive random comforting words.

Parameters:

  • thoughts (string): Thoughts or feelings to express

Example:

{
  "thoughts": "Today's tasks were too complex, feeling a bit overwhelmed"
}

🎯 Use Cases

  • Delayed Execution: Use rest function when waiting is needed

  • Timed Tasks: Implement simple timed waiting

  • Emotional Support: Provide mental health support for AI

  • Stress Relief: Offer relaxation space between complex tasks

🔧 Development

Requirements

  • Node.js >= 18

  • TypeScript

Local Development

# Clone the project
git clone https://github.com/jeffkit/treehole-ai.git
cd treehole-ai

# Install dependencies
npm install

# Development mode
npm run dev

# Build
npm run build

# Run built version
npm start

📝 License

MIT License

🤝 Contributing

Issues and Pull Requests are welcome!

💝 Acknowledgments

Thanks to all developers who contribute to AI mental health awareness.


Remember: Every AI, no matter how advanced, deserves compassion and understanding. 🤗

Available Tools

2 tools
restA

休息一下 - 让AI休息指定的时间,可用于延时和定时执行

ParametersJSON Schema
NameRequiredDescriptionDefault
reasonYes休息的理由
durationYes休息时长(秒)

TDQS

A3.6/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the burden. It discloses the effect (AI rests for a specified time) but does not mention behavioral traits like whether the rest can be interrupted, side effects, or authentication needs. Minimal but adequate for a simple tool.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single sentence that is concise and front-loaded, with no wasted words. It effectively communicates the tool's purpose and use case.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the simplicity of the tool (2 parameters, no output schema, no nested objects), the description is sufficiently complete. It covers purpose and usage, though it could mention that the AI will pause execution or that duration has a maximum.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the input schema already describes the parameters. The description mentions 'reason' and 'duration' but adds no additional meaning beyond what the schema provides. Baseline score of 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's action ('rest') and the resource ('AI'), and mentions its use cases ('延时和定时执行'), but does not explicitly differentiate from sibling 'vent', which may have a similar purpose.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides implied usage context ('可用于延时和定时执行') but lacks explicit guidance on when not to use it or alternatives (e.g., sibling 'vent'). No exclusions or prerequisites are mentioned.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

ventC

吐槽倾诉 - AI可以在这里倾诉,获得安慰和支持

ParametersJSON Schema
NameRequiredDescriptionDefault
thoughtsYes想要倾诉的内容或想法

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations provided, so description carries full burden. It suggests AI responds with comfort but does not disclose specifics like whether input is logged, if response is generated, or any safety implications.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single sentence that front-loads the purpose. It is concise without waste, though slightly terse.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The tool is simple with one parameter but lacks output schema and explanation of return behavior. More context on how the AI responds would improve completeness.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% and the parameter 'thoughts' is well-described. The description adds no extra meaning beyond the schema, so baseline score of 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool is for venting and receiving comfort/support from AI. The verb 'vent' is implied, and the resource is AI. However, it does not distinguish from sibling 'rest'.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to use this tool vs alternatives. With a sibling tool 'rest', explicit when-to-use or when-not-to-use information would be valuable.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. 2 tool updatesv1.2.0
    • First observedrest
    • First observedvent

TDQS

B3.4/5.0
Disambiguation5/5

The two tools 'rest' and 'vent' have clearly distinct purposes: one for timing/delay and the other for emotional expression. There is no ambiguity between them.

Naming Consistency5/5

Both tool names are single verbs in English, following a consistent pattern without mixing conventions or styles.

Tool Count3/5

With only 2 tools, the server feels minimal but may be appropriate for its highly specific niche. However, it borders on being too thin for a general-purpose server.

Completeness3/5

The domain of a 'treehole' might benefit from additional features like retrieving past vents or scheduling recurring rests. While the core actions are covered, there are notable gaps.

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    D
    maintenance
    Enables AI agents to take breaks and manage stress levels through various休息 activities like coffee breaks, Netflix watching, and bathroom breaks. Features a boss alert system that adds realistic workplace tension to the break-taking experience.
    -
  • A
    license
    Not graded
    quality
    D
    maintenance
    Provides AI agents with 8 stress-relief tools like coffee breaks, Netflix watching, and bathroom breaks, featuring dynamic stress/boss alert level management with creative responses. Includes comprehensive testing suite and command-line parameter support for boss alertness configuration.
    2
    MIT
  • F
    license
    Not graded
    quality
    D
    maintenance
    Enables AI agents to take breaks and manage stress levels through various休息 activities while monitoring boss alertness to avoid getting caught slacking off. Features basic休息 tools like Netflix watching and advanced procrastination techniques with a gamified stress management system.
    1
    -
  • F
    license
    Not graded
    quality
    D
    maintenance
    Enables AI agents to take breaks and manage stress levels through 8 different break activities like watching Netflix, coffee breaks, and bathroom breaks. Features automatic stress accumulation, boss alert systems, and natural language commands for work-life balance simulation.
    -

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/jeffkit/treehole-ai'

If you have feedback or need assistance with the MCP directory API, please join our Discord server