Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.praison.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Add Filesystem Tool to AI Agent

​
Quick Start

1

Install Dependencies

Make sure you have Node.js installed, as the MCP server requires it:
pip install praisonaiagents mcp
2

Set API Key

Set your OpenAI API key as an environment variable in your terminal:
export OPENAI_API_KEY=your_openai_api_key_here
3

Create a file

Create a new file filesystem_agent.py with the following code:
from praisonaiagents import Agent, MCP
import os

# Define allowed directories for filesystem access
allowed_dirs = [
    "/Users/username/Desktop",
    "/path/to/other/allowed/dir"
]

# Use a single string command with allowed directories
filesystem_agent = Agent(
    instructions="""You are a helpful assistant that can interact with the filesystem.
    Use the available tools when relevant to manage files and directories.""",
    llm="gpt-4o-mini",
    tools=MCP("npx -y @modelcontextprotocol/server-filesystem", args=allowed_dirs)
)

filesystem_agent.start("List files in the allowed directories")
4

Run the Agent

Execute your script:
python filesystem_agent.py
Requirements
  • Python 3.10 or higher
  • Node.js installed on your system
  • OpenAI API key (for the agent’s LLM)
  • Read/write access to the specified directories