[{"_1":2,"_416":-5,"_417":-5},"loaderData",{"_3":4,"_22":23,"_323":324},"root",{"_5":6,"_7":8},"toasts",[],"visitor",{"_9":10,"_11":12},"viewportWidth",1280,"visitorSession",{"_13":14,"_16":17,"_18":-5,"_19":20,"_21":-5},"attributes",[15],"bot","id",16698126,"membership","referenceId","01997f54-e293-7148-8ea1-9575d93c95b4","userAccount","routes/_public/mcp/servers/~namespace/~slug/_pages/_layout",{"_24":25,"_66":-5,"_67":26,"_27":68,"_239":240,"_322":221},"availableLocales",[26,38,45,52,59],{"_27":28,"_31":35,"_36":37},"mcpServer",{"_29":30,"_31":32,"_33":34},"description","A modular server implementation for Claude AI assistants with integrated tools, enabling Claude to perform actions and access external resources like file systems, web searches, browser automation, financial data, and document generation.","name","MCP Unified Server","readme","# MCP Tool Kit\n\nA modular server implementation for building high precision vertical AI agents. Intended for use building high precision vertical AI agents, but can deploy to gain access to general tool functionality.\n\nUses >=50% less code than the Python MCP SDK alone.\n\n[![PyPI version](https://img.shields.io/pypi/v/mcptoolkit.svg)](https://pypi.org/project/mcptoolkit/)\n[![Python versions](https://img.shields.io/pypi/pyversions/mcptoolkit.svg)](https://pypi.org/project/mcptoolkit/)\n[![License](https://img.shields.io/github/license/getfounded/mcp-tool-kit.svg)](https://github.com/getfounded/mcp-tool-kit/blob/main/LICENSE)\n\n### Benefits of This Approach\n\n- **Reduces Cognitive Load on Claude**: Claude doesn't need to reason about the sequence of tool calls\n- **Encapsulates Domain Knowledge**: The agent can contain domain-specific logic about how to perform tasks well in a particular vertical\n- **Simplifies Error Handling**: The agent can handle errors and retries internally without Claude's involvement\n- **Enables Complex Workflows**: Multi-step processes that would be difficult to coordinate through individual tool calls\n- **Maintains Conversational Flow**: The user isn't exposed to the complexity of the underlying system\n\n### Example Scenario\nHere's a concrete example of Claude invoking a vertical agent:\n\n```\nUser: \"I need a comprehensive analysis of the electric vehicle market for a presentation tomorrow.\"\n\nClaude: [recognizes this requires multiple tools and domain expertise]\n\nClaude: \"I'll help you with that comprehensive EV market analysis. I'll need to gather the latest market data, news, and trends. This will take a moment...\"\n\n[Behind the scenes, Claude calls a MarketAnalysisAgent]\n\nClaude -> MarketAnalysisAgent.analyze_market(\n sector=\"electric vehicles\",\n include_news=True,\n include_market_data=True,\n create_presentation=True\n)\n\n[The agent orchestrates multiple tool calls using your toolkit]\n- news_search for recent EV news\n- brave_web_search for market data\n- sequential_thinking for analysis\n- write_file to save the report\n- ppt_create_presentation to generate slides\n\n[Agent returns results to Claude]\n\nClaude: \"I've analyzed the electric vehicle market for you. Here are the key findings:\n1. Tesla continues to lead with 65% market share in North America\n2. BYD has overtaken VW in global sales volume\n3. Battery technology breakthroughs are accelerating adoption\n\nI've also created a presentation with detailed charts and data. You can find it saved as 'EV_Market_Analysis.pptx' in your working directory.\"\n```\n## Overview\n\nThe MCP Unified Server provides a unified interface for Claude to interact with various external systems and tools including:\n\n- **File system operations**: Read, write, and manipulate files\n- **Time tools**: Get current time in different timezones, convert between timezones\n- **Sequential thinking**: A tool for dynamic and reflective problem-solving\n- **Brave Search**: Web and local search capabilities\n- **Browser automation**: Complete browser control via Playwright\n- **World Bank API**: Access to economic and development data\n- **News API**: Access to global news sources and articles\n- **PowerPoint**: Create and manipulate PowerPoint presentations\n- **Excel**: Create and manipulate Excel spreadsheets\n- **Yahoo Finance**: Stock market and financial data\n- **FRED**: Federal Reserve Economic Data\n- **Agentic capabilities**: Create and deploy autonomous agents that perform complex tasks\n- **And many more specialized tools**\n\n## 123 Total Tools Available\n![Claude screenshot with tools](./static/123_tools.png)\n\n## Quickstart Guide: Deploy Your First MCP Server with Default Tools\nNote: ensure that you have git downloaded (https://git-scm.com/downloads) and Docker downloaded (https://www.docker.com/products/docker-desktop/) and running. You also must ensure the git executable file is added to path (instructions towards end of this README).\n\n## Docker deployment (recommended & most stable)\n1) Clone the repository:\n```git \nclone https://github.com/getfounded/mcp-tool-kit.git\ncd mcp-tool-kit\n```\n2) You can then use Docker in one of two ways:\nOption 1 - Using docker-compose:\n```\ndocker-compose up\n```\nOption 2 - Direct Docker command:\n```\ndocker run -p 8000:8000 -v ~/documents:/app/documents getfounded/mcp-tool-kit:latest\n```\n\nThe repository includes a sample Claude desktop configuration file (`claude_desktop_config.json`) that you can use:\n\n```json\n{\n \"mcpServers\": {\n \"unified\": {\n \"command\": \"docker\",\n \"args\": [\n \"exec\",\n \"-i\",\n \"mcp-tool-kit-mcp-server\",\n \"python\",\n \"-u\",\n \"mcp_unified_server.py\"\n ],\n \"useStdio\": true\n }\n }\n}\n```\n### Troubleshooting docker\nIf you are getting errors running docker, it is likely that the image name is incorrect in the Claude desktop configuration file. A common fix is to use the following json for configuration:\n\n```json\n{\n \"mcpServers\": {\n \"unified\": {\n \"command\": \"docker\",\n \"args\": [\n \"exec\",\n \"-i\",\n \"mcp-tool-kit-mcp-server-1\",\n \"python\",\n \"-u\",\n \"mcp_unified_server.py\"\n ],\n \"useStdio\": true\n }\n }\n}\n```\n\n## Install via pip\n```bash\n# Simple installation\npip install mcptoolkit\n\n# Launch the server with default configuration\nmcptoolkit-server\n```\n\n\nLocal server basic configuration:\n\n```json\n{\n \"tools\": [\n {\n \"name\": \"MCP Toolkit\",\n \"url\": \"http://localhost:8000\"\n }\n ],\n \"settings\": {\n \"allowed_directories\": [\"~/Documents\", \"~/Downloads\"],\n \"default_tools\": [\"MCP Toolkit\"]\n }\n}\n```\n\n## Configure Claude Desktop to Access Your Server\n\n1. Open Claude Desktop app\n2. Go to File > Settings > Developer > Edit config\n3. Add the 'claude_desktop_configuration.json' file\n4. Save the configuration\n5. Restart the MCP server with your new tool integrated\n6. Restart and Open Claude Desktop app (for windows users you must use task manager to end task for all Claude instances)\n\n\nYou can import this configuration in the Claude desktop app or use it as a reference to create your own.\n\nYou now have immediate access to powerful capabilities including file operations, web search, time tools, and more—without requiring any API keys or complex setup.\n\n## Setting Up Environment Variables\n\nAfter cloning the repository, you have two options to configure your environment variables:\n\n### Option 1: Interactive Setup Script\n\nRun the setup script which will guide you through setting up your environment variables:\n\n```bash\npython setup_env.py\n```\n\nThis script will create a `.env` file in the repository with your configuration.\n\n### Option 2: Manual Configuration\n\nAlternatively, you can manually create a `.env` file in the repository root with the following variables:\n\n```\n# API Keys for external services\nBRAVE_API_KEY=your_brave_api_key\nNEWS_API_KEY=your_news_api_key\nFRED_API_KEY=your_fred_api_key\n\n# Application configuration\nSTREAMLIT_APPS_DIR=/path/to/streamlit/apps\nMCP_FILESYSTEM_DIRS=/path/to/allowed/dir1,/path/to/allowed/dir2\nMCP_LOG_LEVEL=info\n```\n### Sample Claude Prompts\n\nOnce set up, you can ask Claude to use the tools with prompts like:\n\n- \"Search the web for the latest AI research papers and summarize the findings.\"\n- \"Create a PowerPoint presentation about climate change with three slides.\"\n- \"Use the weather_checker agent to tell me the current conditions in Tokyo.\"\n- \"Can you use the quick_lookup agent to research quantum computing advances?\"\n- \"Download my QuickBooks invoice data and analyze our revenue for the past quarter.\"\n- \"Set up a product on my Shopify store with these details and pricing.\"\n- \"Get the current stock price and historical data for Tesla using Yahoo Finance.\"\n- \"Analyze inflation trends using FRED economic data for the past 5 years.\"\n- \"Use browser automation to fill out this form at [website URL].\"\n- \"Read the text file in my Downloads folder named 'project_notes.txt'.\"\n- \"Get the latest news headlines about technology.\"\n\n\n## Available Tools\n\n### File System Tools\n- `read_file`: Read contents of a file\n- `read_multiple_files`: Read multiple files simultaneously\n- `write_file`: Create or overwrite a file\n- `edit_file`: Make line-based edits to a file\n- `create_directory`: Create a new directory\n- `list_directory`: Get directory contents\n- `directory_tree`: Get a recursive tree view\n- `move_file`: Move or rename files/directories\n- `search_files`: Search for files matching a pattern\n- `get_file_info`: Get file metadata\n- `list_allowed_directories`: List allowed directories\n\n\n- **Browser_Automation:**\n - `playwright_launch_browser`: Launch a new browser instance\n - `playwright_navigate`: Navigate to a URL\n - `playwright_screenshot`: Take a screenshot\n - `playwright_click`: Click on an element\n - `playwright_fill`: Fill an input field\n - `playwright_evaluate`: Execute JavaScript\n - `playwright_get_content`: Get the HTML content of a page\n\n### Agent Tools\n- `run_agent`: Execute a registered agent with parameters\n- `list_agents`: List all available agents and their metadata\n\n### Financial Data Tools\n- **Yahoo Finance:**\n - `yfinance`: Get stock quotes and historical data\n - `yfinance_get_quote`: Get current stock quote\n - `yfinance_get_history`: Get historical stock data\n - `yfinance_get_info`: Get detailed company information\n - `yfinance_get_options`: Get options chain data\n - `yfinance_get_recommendations`: Get analyst recommendations\n\n- **FRED (Federal Reserve Economic Data):**\n - `fred_get_series`: Get economic data series\n - `fred_get_series_info`: Get metadata about a series\n - `fred_search`: Search for economic data series\n - `fred_get_category`: Browse data by category\n - `fred_get_releases`: Get economic data releases\n - `fred_get_sources`: Get data sources\n\n### Time Tools\n- `get_current_time`: Get current time in a specified timezone\n- `convert_time`: Convert time between timezones\n\n### Sequential Thinking\n- `sequentialthinking`: A tool for breaking down complex problems using a step-by-step thinking process\n\n### Brave Search\n- `brave_web_search`: Perform web searches\n- `brave_local_search`: Search for local businesses and places\n\n### World Bank API\n- `worldbank_get_indicator`: Get indicator data for a country\n\n### News API\n- `news_top_headlines`: Get top news headlines\n- `news_search`: Search for news articles\n- `news_sources`: List available news sources\n\n### PowerPoint Tools\n- `ppt_create_presentation`: Create a new PowerPoint presentation\n- `ppt_open_presentation`: Open an existing presentation\n- `ppt_save_presentation`: Save a presentation\n- `ppt_add_slide`: Add a new slide\n- `ppt_add_text`: Add text to a slide\n- `ppt_add_image`: Add an image to a slide\n- `ppt_add_chart`: Add a chart to a slide\n- `ppt_add_table`: Add a table to a slide\n- `ppt_analyze_presentation`: Analyze presentation structure\n- `ppt_enhance_presentation`: Suggest enhancements\n- `ppt_generate_presentation`: Generate a presentation from text\n- `ppt_command`: Process natural language commands\n\nFor a complete list of available tools, see the documentation or browse the tools directory.\nFor a complete list of available tools, see the documentation or browse the tools directory.\n\n### Adding a New Tool Module\n\n1. Create a new file in the `tools` directory (e.g., `my_tool.py`)\n2. Follow the existing module pattern:\n - Create service class\n - Define tool functions\n - Implement registration functions\n3. Update `mcp_unified_server.py` to import and register your new module\n\n### Extending an Existing Tool Module\n\n1. Add new methods to the service class\n2. Add new tool functions\n3. Update the registration function to include your new tools\n\n### Development with Docker\n\nYou can use Docker for development to ensure a consistent environment:\n\n```bash\n# Build a development image\ndocker build -t mcp-tool-kit:dev .\n\n# Run with source code mounted for development\ndocker run -p 8000:8000 \\\n -v $(pwd):/app \\\n -v ~/documents:/app/documents \\\n mcp-tool-kit:dev\n```\n\nThis mounts your local repository into the container, so changes to the code are reflected immediately (for most files).\n\n## Philosophical Perspective: The Human-AI Cognitive Partnership\n\nThe MCP Tool Kit represents a paradigm shift in how we conceptualize the relationship between human intelligence and AI systems. Rather than positioning AI as a mere tool for task automation, this framework establishes a cognitive partnership where human strategic thinking and AI operational capabilities complement each other in profound ways.\n\nThe agentic architecture embodies a transformative vision: AI systems that can independently interpret context, make decisions within bounded parameters, and execute complex sequences of actions—all while maintaining human oversight and strategic direction. This represents not merely a technological advance, but a fundamentally new model for human-machine collaboration.\n\nIn this evolving cognitive landscape, the most successful implementations will be those that thoughtfully balance technological potential with human capabilities, creating interfaces that enhance rather than replace human decision-making and creativity.\n\n## Troubleshooting\n\n- **Module not loading**: Check the import path and dependencies\n- **API key errors**: Verify your API keys in the `.env` file\n- **Permission errors**: Check the allowed directories in `MCP_FILESYSTEM_DIRS`\n- **Connection errors**: Ensure the server is running and the port is accessible\n- **Agent not detected**: Verify the agent file is in the correct directory and follows the required format\n- **Issues with path**: Make sure that git is added to path as per the below instruciton\n\n#To add Git to the PATH on Windows, follow these steps:\n\n1) Locate Git Installation: Determine the path where Git is installed on your system. Common paths include C:\\Program Files\\Git\\bin\\git.exe and C:\\Program Files\\Git\\cmd for a standard Git installation, or C:\\Users\\\\AppData\\Local\\GitHub\\PortableGit_\\bin and C:\\Users\\\\AppData\\Local\\GitHub\\PortableGit_\\cmd if you installed Git through GitHub for Windows or GitHub Desktop.\n\n2) Edit Environment Variables: Open the \"Edit Environment Variables\" app either through the Control Panel or by searching for \"Edit the system environment variables\" in the Start menu. Under the \"System variables\" section, find the \"Path\" variable, click \"Edit...\", and add the path to the Git executable and command files. Ensure there are no spaces around the semicolons separating paths.\n\n3) Save Changes: After adding the Git paths, click \"OK\" to save your changes. Close and reopen any command prompt windows to apply the new PATH settings.\n\n4) Verify Installation: Open a command prompt and run git --version to verify that Git is accessible from the command line.\n\n## License\n\nThe MCP Unified Server is licensed under the MIT License.\n\n## Acknowledgements\n\nThis project uses several open-source libraries and APIs:\n- MCP SDK for Claude AI assistants\n- NewsAPI for news access\n- Brave Search API for web search\n- World Bank API for economic data\n- python-pptx for PowerPoint manipulation\n- XlsxWriter for Excel spreadsheets\n","English","tag","en-US",{"_27":39,"_31":43,"_36":44},{"_29":40,"_31":41,"_33":42},"Una implementación de servidor modular para los asistentes de inteligencia artificial de Claude con herramientas integradas, que le permiten a Claude realizar acciones y acceder a recursos externos como sistemas de archivos, búsquedas web, automatización del navegador, datos financieros y generación de documentos.","Servidor unificado MCP","# Kit de herramientas MCP\n\nUna implementación de servidor modular para crear agentes de IA verticales de alta precisión. Diseñado para crear agentes de IA verticales de alta precisión, pero con implementación para acceder a la funcionalidad general de la herramienta.\n\nUtiliza >=50% menos código que el SDK de Python MCP solo.\n\n[![Versión de PyPI](https://img.shields.io/pypi/v/mcptoolkit.svg)](https://pypi.org/project/mcptoolkit/) [![Versiones de Python](https://img.shields.io/pypi/pyversions/mcptoolkit.svg)](https://pypi.org/project/mcptoolkit/) [![Licencia](https://img.shields.io/github/license/getfounded/mcp-tool-kit.svg)](https://github.com/getfounded/mcp-tool-kit/blob/main/LICENSE)\n\n### Beneficios de este enfoque\n\n* **Reduce la carga cognitiva de Claude** : Claude no necesita razonar sobre la secuencia de llamadas a herramientas.\n* **Encapsula el conocimiento del dominio** : el agente puede contener lógica específica del dominio sobre cómo realizar bien las tareas en un sector vertical en particular.\n* **Simplifica el manejo de errores** : el agente puede manejar errores y reintentos internamente sin la participación de Claude\n* **Permite flujos de trabajo complejos** : procesos de varios pasos que serían difíciles de coordinar mediante llamadas a herramientas individuales\n* **Mantiene el flujo conversacional** : el usuario no está expuesto a la complejidad del sistema subyacente.\n\n### Ejemplo de escenario\n\nHe aquí un ejemplo concreto de Claude invocando un agente vertical:\n\n```\nUser: \"I need a comprehensive analysis of the electric vehicle market for a presentation tomorrow.\"\n\nClaude: [recognizes this requires multiple tools and domain expertise]\n\nClaude: \"I'll help you with that comprehensive EV market analysis. I'll need to gather the latest market data, news, and trends. This will take a moment...\"\n\n[Behind the scenes, Claude calls a MarketAnalysisAgent]\n\nClaude -> MarketAnalysisAgent.analyze_market(\n sector=\"electric vehicles\",\n include_news=True,\n include_market_data=True,\n create_presentation=True\n)\n\n[The agent orchestrates multiple tool calls using your toolkit]\n- news_search for recent EV news\n- brave_web_search for market data\n- sequential_thinking for analysis\n- write_file to save the report\n- ppt_create_presentation to generate slides\n\n[Agent returns results to Claude]\n\nClaude: \"I've analyzed the electric vehicle market for you. Here are the key findings:\n1. Tesla continues to lead with 65% market share in North America\n2. BYD has overtaken VW in global sales volume\n3. Battery technology breakthroughs are accelerating adoption\n\nI've also created a presentation with detailed charts and data. You can find it saved as 'EV_Market_Analysis.pptx' in your working directory.\"\n```\n\n## Descripción general\n\nEl servidor unificado MCP proporciona una interfaz unificada para que Claude interactúe con varios sistemas y herramientas externos, incluidos:\n\n* **Operaciones del sistema de archivos** : leer, escribir y manipular archivos\n* **Herramientas de tiempo** : obtener la hora actual en diferentes zonas horarias, convertir entre zonas horarias\n* **Pensamiento secuencial** : una herramienta para la resolución dinámica y reflexiva de problemas\n* **Brave Search** : capacidades de búsqueda web y local\n* **Automatización del navegador** : control completo del navegador mediante Playwright\n* **API del Banco Mundial** : Acceso a datos económicos y de desarrollo\n* **API de noticias** : acceso a fuentes de noticias y artículos globales\n* **PowerPoint** : Crea y manipula presentaciones de PowerPoint\n* **Excel** : crear y manipular hojas de cálculo de Excel\n* **Yahoo Finanzas** : datos financieros y bursátiles\n* **FRED** : Datos económicos de la Reserva Federal\n* **Capacidades de agente** : cree e implemente agentes autónomos que realicen tareas complejas\n* **Y muchas más herramientas especializadas**\n\n## 123 herramientas en total disponibles\n\n![Captura de pantalla de Claude con herramientas](./static/123_tools.png)\n\n## Guía de inicio rápido: Implemente su primer servidor MCP con herramientas predeterminadas\n\nNota: Asegúrese de tener Git descargado ( ) y Docker descargado ( ) y ejecutándose. También debe asegurarse de que el archivo ejecutable de Git esté agregado a la ruta (consulte las instrucciones al final de este archivo README).\n\n## Implementación de Docker (recomendada y más estable)\n\n1. Clonar el repositorio:\n\n```git\nclone https://github.com/getfounded/mcp-tool-kit.git\ncd mcp-tool-kit\n```\n\n2. Luego puede usar Docker de una de dos maneras: Opción 1: usar docker-compose:\n\n```\ndocker-compose up\n```\n\nOpción 2 - Comando directo de Docker:\n\n```\ndocker run -p 8000:8000 -v ~/documents:/app/documents getfounded/mcp-tool-kit:latest\n```\n\nEl repositorio incluye un archivo de configuración de escritorio de Claude de muestra ( `claude_desktop_config.json` ) que puedes usar:\n\n```json\n{\n \"mcpServers\": {\n \"unified\": {\n \"command\": \"docker\",\n \"args\": [\n \"exec\",\n \"-i\",\n \"mcp-tool-kit-mcp-server\",\n \"python\",\n \"-u\",\n \"mcp_unified_server.py\"\n ],\n \"useStdio\": true\n }\n }\n}\n```\n\n### Solución de problemas de Docker\n\nSi recibe errores al ejecutar Docker, es probable que el nombre de la imagen sea incorrecto en el archivo de configuración del escritorio de Claude. Una solución habitual es usar el siguiente JSON para la configuración:\n\n```json\n{\n \"mcpServers\": {\n \"unified\": {\n \"command\": \"docker\",\n \"args\": [\n \"exec\",\n \"-i\",\n \"mcp-tool-kit-mcp-server-1\",\n \"python\",\n \"-u\",\n \"mcp_unified_server.py\"\n ],\n \"useStdio\": true\n }\n }\n}\n```\n\n## Instalar mediante pip\n\n```bash\n# Simple installation\npip install mcptoolkit\n\n# Launch the server with default configuration\nmcptoolkit-server\n```\n\nConfiguración básica del servidor local:\n\n```json\n{\n \"tools\": [\n {\n \"name\": \"MCP Toolkit\",\n \"url\": \"http://localhost:8000\"\n }\n ],\n \"settings\": {\n \"allowed_directories\": [\"~/Documents\", \"~/Downloads\"],\n \"default_tools\": [\"MCP Toolkit\"]\n }\n}\n```\n\n## Configurar Claude Desktop para acceder a su servidor\n\n1. Abra la aplicación Claude Desktop\n2. Vaya a Archivo > Configuración > Desarrollador > Editar configuración\n3. Agregue el archivo 'claude\\_desktop\\_configuration.json'\n4. Guardar la configuración\n5. Reinicie el servidor MCP con su nueva herramienta integrada\n6. Reinicie y abra la aplicación de escritorio Claude (los usuarios de Windows deben usar el administrador de tareas para finalizar la tarea en todas las instancias de Claude)\n\nPuedes importar esta configuración en la aplicación de escritorio de Claude o usarla como referencia para crear la tuya propia.\n\nAhora tiene acceso inmediato a potentes capacidades que incluyen operaciones de archivos, búsqueda web, herramientas de tiempo y más, sin necesidad de claves API ni configuraciones complejas.\n\n## Configuración de variables de entorno\n\nDespués de clonar el repositorio, tiene dos opciones para configurar sus variables de entorno:\n\n### Opción 1: Guión de configuración interactivo\n\nEjecute el script de instalación que lo guiará en la configuración de sus variables de entorno:\n\n```bash\npython setup_env.py\n```\n\nEste script creará un archivo `.env` en el repositorio con su configuración.\n\n### Opción 2: Configuración manual\n\nAlternativamente, puede crear manualmente un archivo `.env` en la raíz del repositorio con las siguientes variables:\n\n```\n# API Keys for external services\nBRAVE_API_KEY=your_brave_api_key\nNEWS_API_KEY=your_news_api_key\nFRED_API_KEY=your_fred_api_key\n\n# Application configuration\nSTREAMLIT_APPS_DIR=/path/to/streamlit/apps\nMCP_FILESYSTEM_DIRS=/path/to/allowed/dir1,/path/to/allowed/dir2\nMCP_LOG_LEVEL=info\n```\n\n### Ejemplos de indicaciones de Claude\n\nUna vez configurado, puedes pedirle a Claude que use las herramientas con indicaciones como:\n\n* Busque en la web los últimos artículos de investigación sobre IA y resuma los hallazgos.\n* \"Crea una presentación de PowerPoint sobre el cambio climático con tres diapositivas\".\n* \"Utilice el agente weather\\_checker para indicarme las condiciones actuales en Tokio\".\n* \"¿Puedes utilizar el agente de búsqueda rápida para investigar los avances en computación cuántica?\"\n* Descargue los datos de mis facturas de QuickBooks y analice nuestros ingresos del último trimestre.\n* \"Configure un producto en mi tienda Shopify con estos detalles y precios\".\n* \"Obtenga el precio actual de las acciones y los datos históricos de Tesla utilizando Yahoo Finance\".\n* \"Analice las tendencias de inflación utilizando datos económicos de FRED de los últimos 5 años\".\n* \"Utilice la automatización del navegador para completar este formulario en \\[URL del sitio web]\".\n* \"Lea el archivo de texto en mi carpeta de Descargas llamado 'project\\_notes.txt'.\"\n* \"Obtenga los últimos titulares de noticias sobre tecnología\".\n\n## Herramientas disponibles\n\n### Herramientas del sistema de archivos\n\n* `read_file` : Leer el contenido de un archivo\n\n* `read_multiple_files` : Leer varios archivos simultáneamente\n\n* `write_file` : Crea o sobrescribe un archivo\n\n* `edit_file` : Realiza ediciones basadas en líneas en un archivo\n\n* `create_directory` : Crea un nuevo directorio\n\n* `list_directory` : Obtener el contenido del directorio\n\n* `directory_tree` : Obtener una vista de árbol recursiva\n\n* `move_file` : Mover o renombrar archivos/directorios\n\n* `search_files` : busca archivos que coincidan con un patrón\n\n* `get_file_info` : Obtener metadatos del archivo\n\n* `list_allowed_directories` : Lista de directorios permitidos\n\n* **Automatización del navegador:**\n\n * `playwright_launch_browser` : Inicia una nueva instancia del navegador\n * `playwright_navigate` : Navegar a una URL\n * `playwright_screenshot` : Tomar una captura de pantalla\n * `playwright_click` : Haz clic en un elemento\n * `playwright_fill` : Rellene un campo de entrada\n * `playwright_evaluate` : Ejecutar JavaScript\n * `playwright_get_content` : Obtener el contenido HTML de una página\n\n### Herramientas del agente\n\n* `run_agent` : Ejecuta un agente registrado con parámetros\n* `list_agents` : enumera todos los agentes disponibles y sus metadatos\n\n### Herramientas de datos financieros\n\n* **Yahoo Finanzas:**\n\n * `yfinance` : Obtenga cotizaciones de acciones y datos históricos\n * `yfinance_get_quote` : Obtener la cotización actual de las acciones\n * `yfinance_get_history` : Obtener datos históricos de acciones\n * `yfinance_get_info` : Obtenga información detallada de la empresa\n * `yfinance_get_options` : Obtener datos de la cadena de opciones\n * `yfinance_get_recommendations` : Obtenga recomendaciones de analistas\n\n* **FRED (Datos económicos de la Reserva Federal):**\n\n * `fred_get_series` : Obtener series de datos económicos\n * `fred_get_series_info` : Obtener metadatos sobre una serie\n * `fred_search` : Búsqueda de series de datos económicos\n * `fred_get_category` : Explorar datos por categoría\n * `fred_get_releases` : Obtener publicaciones de datos económicos\n * `fred_get_sources` : Obtener fuentes de datos\n\n### Herramientas de tiempo\n\n* `get_current_time` : Obtener la hora actual en una zona horaria específica\n* `convert_time` : Convertir la hora entre zonas horarias\n\n### Pensamiento secuencial\n\n* `sequentialthinking` : una herramienta para descomponer problemas complejos mediante un proceso de pensamiento paso a paso\n\n### Búsqueda valiente\n\n* `brave_web_search` : Realizar búsquedas web\n* `brave_local_search` : Busca negocios y lugares locales\n\n### API del Banco Mundial\n\n* `worldbank_get_indicator` : Obtener datos de indicadores para un país\n\n### API de noticias\n\n* `news_top_headlines` : Obtenga los principales titulares de las noticias\n* `news_search` : Buscar artículos de noticias\n* `news_sources` : Lista de fuentes de noticias disponibles\n\n### Herramientas de PowerPoint\n\n* `ppt_create_presentation` : Crea una nueva presentación de PowerPoint\n* `ppt_open_presentation` : Abrir una presentación existente\n* `ppt_save_presentation` : Guardar una presentación\n* `ppt_add_slide` : Agregar una nueva diapositiva\n* `ppt_add_text` : Agregar texto a una diapositiva\n* `ppt_add_image` : Agregar una imagen a una diapositiva\n* `ppt_add_chart` : Agregar un gráfico a una diapositiva\n* `ppt_add_table` : Agregar una tabla a una diapositiva\n* `ppt_analyze_presentation` : Analizar la estructura de la presentación\n* `ppt_enhance_presentation` : Sugerir mejoras\n* `ppt_generate_presentation` : Generar una presentación a partir de texto\n* `ppt_command` : Procesar comandos en lenguaje natural\n\nPara obtener una lista completa de las herramientas disponibles, consulte la documentación o explore el directorio de herramientas.\n\n### Agregar un nuevo módulo de herramientas\n\n1. Crea un nuevo archivo en el directorio `tools` (por ejemplo, `my_tool.py` )\n2. Siga el patrón del módulo existente:\n * Crear clase de servicio\n * Definir funciones de herramientas\n * Implementar funciones de registro\n3. Actualice `mcp_unified_server.py` para importar y registrar su nuevo módulo\n\n### Ampliación de un módulo de herramientas existente\n\n1. Agregar nuevos métodos a la clase de servicio\n2. Agregar nuevas funciones de herramientas\n3. Actualice la función de registro para incluir sus nuevas herramientas\n\n### Desarrollo con Docker\n\nPuede utilizar Docker para el desarrollo para garantizar un entorno consistente:\n\n```bash\n# Build a development image\ndocker build -t mcp-tool-kit:dev .\n\n# Run with source code mounted for development\ndocker run -p 8000:8000 \\\n -v $(pwd):/app \\\n -v ~/documents:/app/documents \\\n mcp-tool-kit:dev\n```\n\nEsto monta su repositorio local en el contenedor, por lo que los cambios en el código se reflejan inmediatamente (para la mayoría de los archivos).\n\n## Perspectiva filosófica: La colaboración cognitiva entre humanos e IA\n\nEl Kit de Herramientas MCP representa un cambio de paradigma en la forma en que conceptualizamos la relación entre la inteligencia humana y los sistemas de IA. En lugar de considerar la IA como una mera herramienta para la automatización de tareas, este marco establece una alianza cognitiva donde el pensamiento estratégico humano y las capacidades operativas de la IA se complementan profundamente.\n\nLa arquitectura agencial encarna una visión transformadora: sistemas de IA capaces de interpretar el contexto de forma independiente, tomar decisiones dentro de parámetros definidos y ejecutar secuencias complejas de acciones, todo ello manteniendo la supervisión humana y la dirección estratégica. Esto representa no solo un avance tecnológico, sino un modelo fundamentalmente nuevo para la colaboración entre humanos y máquinas.\n\nEn este panorama cognitivo en evolución, las implementaciones más exitosas serán aquellas que equilibren cuidadosamente el potencial tecnológico con las capacidades humanas, creando interfaces que mejoren en lugar de reemplazar la toma de decisiones y la creatividad humanas.\n\n## Solución de problemas\n\n* **El módulo no se carga** : Verifique la ruta de importación y las dependencias\n* **Errores de clave API** : Verifique sus claves API en el archivo `.env`\n* **Errores de permisos** : Verifique los directorios permitidos en `MCP_FILESYSTEM_DIRS`\n* **Errores de conexión** : asegúrese de que el servidor esté en ejecución y el puerto sea accesible\n* **Agente no detectado** : Verifique que el archivo del agente esté en el directorio correcto y siga el formato requerido\n* **Problemas con la ruta** : asegúrese de que git se agregue a la ruta según las siguientes instrucciones\n\n\\#Para agregar Git a PATH en Windows, siga estos pasos:\n\n1. Localizar la instalación de Git: Determine la ruta donde está instalado Git en su sistema. Las rutas comunes incluyen C:\\Archivos de programa\\Git\\bin\\git.exe y C:\\Archivos de programa\\Git\\cmd para una instalación estándar de Git, o C:\\Users\\AppData\\Local\\GitHub\\PortableGit\\_\\bin y C:\\Users\\AppData\\Local\\GitHub\\PortableGit\\_\\cmd si instaló Git a través de GitHub para Windows o GitHub Desktop.\n\n2. Editar variables de entorno: Abra la aplicación \"Editar variables de entorno\" desde el Panel de control o buscando \"Editar las variables de entorno del sistema\" en el menú Inicio. En la sección \"Variables del sistema\", busque la variable \"Ruta\", haga clic en \"Editar...\" y añada la ruta a los archivos ejecutables y de comandos de Git. Asegúrese de que no haya espacios entre los puntos y comas que separan las rutas.\n\n3. Guardar cambios: Después de agregar las rutas de Git, haga clic en \"Aceptar\" para guardar los cambios. Cierre y vuelva a abrir cualquier ventana del símbolo del sistema para aplicar la nueva configuración de PATH.\n\n4. Verificar la instalación: abra un símbolo del sistema y ejecute git --version para verificar que Git sea accesible desde la línea de comando.\n\n## Licencia\n\nEl servidor unificado MCP tiene licencia MIT.\n\n## Expresiones de gratitud\n\nEste proyecto utiliza varias bibliotecas y API de código abierto:\n\n* SDK de MCP para asistentes de IA de Claude\n* NewsAPI para acceder a noticias\n* API de Brave Search para búsqueda web\n* API del Banco Mundial para datos económicos\n* python-pptx para la manipulación de PowerPoint\n* XlsxWriter para hojas de cálculo de Excel","Spanish","es-ES",{"_27":46,"_31":50,"_36":51},{"_29":47,"_31":48,"_33":49},"統合ツールを備えた Claude AI アシスタント用のモジュラーサーバー実装。これにより、Claude はアクションを実行し、ファイルシステム、Web 検索、ブラウザー自動化、財務データ、ドキュメント生成などの外部リソースにアクセスできるようになります。","MCP統合サーバー","# MCP ツールキット\n\n高精度な垂直AIエージェントを構築するためのモジュール型サーバー実装。高精度な垂直AIエージェントの構築を目的としていますが、一般的なツール機能へのアクセスにも利用できます。\n\nPython MCP SDK 単独の場合よりも 50% 以上少ないコードを使用します。\n\n[![PyPIバージョン](https://img.shields.io/pypi/v/mcptoolkit.svg)](https://pypi.org/project/mcptoolkit/) [![Pythonのバージョン](https://img.shields.io/pypi/pyversions/mcptoolkit.svg)](https://pypi.org/project/mcptoolkit/)[![ライセンス](https://img.shields.io/github/license/getfounded/mcp-tool-kit.svg)](https://github.com/getfounded/mcp-tool-kit/blob/main/LICENSE)\n\n### このアプローチの利点\n\n* **クロードの認知負荷を軽減**: クロードはツール呼び出しの順序を考える必要がない\n* **ドメイン知識をカプセル化**：エージェントは、特定の垂直分野でタスクをうまく実行する方法に関するドメイン固有のロジックを含めることができます。\n* **エラー処理を簡素化**: エージェントは、クロードの関与なしにエラーと再試行を内部的に処理できます。\n* **複雑なワークフローを実現**: 個々のツール呼び出しでは調整が難しい多段階のプロセス\n* **会話の流れを維持する**: ユーザーは基盤となるシステムの複雑さにさらされることはありません\n\n### シナリオ例\n\n以下は、クロードによる垂直エージェントの呼び出しの具体的な例です。\n\n```\nUser: \"I need a comprehensive analysis of the electric vehicle market for a presentation tomorrow.\"\n\nClaude: [recognizes this requires multiple tools and domain expertise]\n\nClaude: \"I'll help you with that comprehensive EV market analysis. I'll need to gather the latest market data, news, and trends. This will take a moment...\"\n\n[Behind the scenes, Claude calls a MarketAnalysisAgent]\n\nClaude -> MarketAnalysisAgent.analyze_market(\n sector=\"electric vehicles\",\n include_news=True,\n include_market_data=True,\n create_presentation=True\n)\n\n[The agent orchestrates multiple tool calls using your toolkit]\n- news_search for recent EV news\n- brave_web_search for market data\n- sequential_thinking for analysis\n- write_file to save the report\n- ppt_create_presentation to generate slides\n\n[Agent returns results to Claude]\n\nClaude: \"I've analyzed the electric vehicle market for you. Here are the key findings:\n1. Tesla continues to lead with 65% market share in North America\n2. BYD has overtaken VW in global sales volume\n3. Battery technology breakthroughs are accelerating adoption\n\nI've also created a presentation with detailed charts and data. You can find it saved as 'EV_Market_Analysis.pptx' in your working directory.\"\n```\n\n## 概要\n\nMCP 統合サーバーは、Claude が次のようなさまざまな外部システムやツールと対話するための統合インターフェイスを提供します。\n\n* **ファイルシステム操作**: ファイルの読み取り、書き込み、操作\n* **時間ツール**: 異なるタイムゾーンの現在の時刻を取得し、タイムゾーン間で変換します\n* **シーケンシャル思考**：動的かつ反省的な問題解決のためのツール\n* **Brave Search** : ウェブ検索とローカル検索機能\n* **ブラウザの自動化**: Playwright による完全なブラウザ制御\n* **世界銀行API** ：経済・開発データへのアクセス\n* **ニュースAPI** : 世界中のニュースソースと記事へのアクセス\n* **PowerPoint** : PowerPoint プレゼンテーションの作成と操作\n* **Excel** : Excel スプレッドシートの作成と操作\n* **Yahoo!ファイナンス**：株式市場と金融データ\n* **FRED** ：連邦準備制度の経済データ\n* **エージェント機能**: 複雑なタスクを実行する自律エージェントを作成して展開します\n* **そして、さらに多くの専門的なツール**\n\n## 利用可能なツールは合計123個\n\n![ツール付きクロードのスクリーンショット](./static/123_tools.png)\n\n## クイックスタートガイド: デフォルトのツールで最初の MCP サーバーを展開する\n\n注：Git（）とDocker（）がダウンロードされ、実行されていることを確認してください。また、Git実行ファイルがパスに追加されていることを確認してください（手順はREADMEの末尾に記載されています）。\n\n## Docker デプロイメント (推奨 & 最も安定)\n\n1. リポジトリをクローンします。\n\n```git\nclone https://github.com/getfounded/mcp-tool-kit.git\ncd mcp-tool-kit\n```\n\n2. 次に、次の 2 つの方法のいずれかで Docker を使用します: オプション 1 - docker-compose を使用する:\n\n```\ndocker-compose up\n```\n\nオプション 2 - 直接 Docker コマンド:\n\n```\ndocker run -p 8000:8000 -v ~/documents:/app/documents getfounded/mcp-tool-kit:latest\n```\n\nリポジトリには、使用できるサンプルの Claude デスクトップ構成ファイル ( `claude_desktop_config.json` ) が含まれています。\n\n```json\n{\n \"mcpServers\": {\n \"unified\": {\n \"command\": \"docker\",\n \"args\": [\n \"exec\",\n \"-i\",\n \"mcp-tool-kit-mcp-server\",\n \"python\",\n \"-u\",\n \"mcp_unified_server.py\"\n ],\n \"useStdio\": true\n }\n }\n}\n```\n\n### dockerのトラブルシューティング\n\ndocker の実行中にエラーが発生する場合は、Claude デスクトップの設定ファイルでイメージ名が間違っている可能性があります。一般的な修正方法としては、以下の JSON ファイルを設定ファイルとして使用します。\n\n```json\n{\n \"mcpServers\": {\n \"unified\": {\n \"command\": \"docker\",\n \"args\": [\n \"exec\",\n \"-i\",\n \"mcp-tool-kit-mcp-server-1\",\n \"python\",\n \"-u\",\n \"mcp_unified_server.py\"\n ],\n \"useStdio\": true\n }\n }\n}\n```\n\n## pip経由でインストール\n\n```bash\n# Simple installation\npip install mcptoolkit\n\n# Launch the server with default configuration\nmcptoolkit-server\n```\n\nローカルサーバーの基本構成:\n\n```json\n{\n \"tools\": [\n {\n \"name\": \"MCP Toolkit\",\n \"url\": \"http://localhost:8000\"\n }\n ],\n \"settings\": {\n \"allowed_directories\": [\"~/Documents\", \"~/Downloads\"],\n \"default_tools\": [\"MCP Toolkit\"]\n }\n}\n```\n\n## Claude Desktop をサーバーにアクセスできるように設定\n\n1. Claudeデスクトップアプリを開く\n2. ファイル > 設定 > 開発者 > 設定の編集に移動します\n3. 「claude\\_desktop\\_configuration.json」ファイルを追加する\n4. 設定を保存する\n5. 新しいツールを統合したMCPサーバーを再起動します\n6. Claude デスクトップアプリを再起動して開きます (Windows ユーザーの場合は、タスクマネージャーを使用してすべての Claude インスタンスのタスクを終了する必要があります)\n\nこの構成を Claude デスクトップアプリにインポートすることも、参照として使用して独自の構成を作成することもできます。\n\nAPI キーや複雑な設定を必要とせずに、ファイル操作、Web 検索、時間ツールなどの強力な機能にすぐにアクセスできるようになりました。\n\n## 環境変数の設定\n\nリポジトリのクローンを作成した後、環境変数を構成するための 2 つのオプションがあります。\n\n### オプション1: 対話型セットアップスクリプト\n\n環境変数の設定をガイドするセットアップスクリプトを実行します。\n\n```bash\npython setup_env.py\n```\n\nこのスクリプトは、設定を含む`.env`ファイルをリポジトリに作成します。\n\n### オプション2: 手動設定\n\nあるいは、次の変数を使用してリポジトリルートに`.env`ファイルを手動で作成することもできます。\n\n```\n# API Keys for external services\nBRAVE_API_KEY=your_brave_api_key\nNEWS_API_KEY=your_news_api_key\nFRED_API_KEY=your_fred_api_key\n\n# Application configuration\nSTREAMLIT_APPS_DIR=/path/to/streamlit/apps\nMCP_FILESYSTEM_DIRS=/path/to/allowed/dir1,/path/to/allowed/dir2\nMCP_LOG_LEVEL=info\n```\n\n### サンプルクロードプロンプト\n\nセットアップが完了したら、次のようなプロンプトを使用して、Claude にツールを使用するように依頼できます。\n\n* 「最新の AI 研究論文を Web で検索し、調査結果を要約します。」\n* 「3 つのスライドで気候変動に関する PowerPoint プレゼンテーションを作成します。」\n* 「weather\\_checker エージェントを使用して、東京の現在の天気を教えてください。」\n* 「quick\\_lookup エージェントを使用して量子コンピューティングの進歩を調査できますか？」\n* 「QuickBooks 請求書データをダウンロードして、過去四半期の収益を分析します。」\n* 「これらの詳細と価格で、Shopify ストアに商品を設定します。」\n* 「Yahoo Finance を使用して、テスラの現在の株価と履歴データを入手します。」\n* 「過去 5 年間の FRED 経済データを使用してインフレ傾向を分析します。」\n* 「ブラウザの自動化を使用して、\\[ウェブサイトの URL] のフォームに入力してください。」\n* 「ダウンロードフォルダー内の 'project\\_notes.txt' というテキストファイルを読み取ります。」\n* 「テクノロジーに関する最新のニュースの見出しを入手してください。」\n\n## 利用可能なツール\n\n### ファイルシステムツール\n\n* `read_file` : ファイルの内容を読み取る\n\n* `read_multiple_files` : 複数のファイルを同時に読み取る\n\n* `write_file` : ファイルを作成または上書きする\n\n* `edit_file` : ファイルの行単位で編集する\n\n* `create_directory` : 新しいディレクトリを作成する\n\n* `list_directory` : ディレクトリの内容を取得する\n\n* `directory_tree` : 再帰ツリービューを取得する\n\n* `move_file` : ファイル/ディレクトリを移動または名前変更する\n\n* `search_files` : パターンに一致するファイルを検索する\n\n* `get_file_info` : ファイルのメタデータを取得する\n\n* `list_allowed_directories` : 許可されたディレクトリを一覧表示する\n\n* **ブラウザ自動化:**\n\n * `playwright_launch_browser` : 新しいブラウザインスタンスを起動する\n * `playwright_navigate` : URLに移動する\n * `playwright_screenshot` : スクリーンショットを撮る\n * `playwright_click` : 要素をクリックする\n * `playwright_fill` : 入力フィールドを埋める\n * `playwright_evaluate` : JavaScriptを実行する\n * `playwright_get_content` : ページのHTMLコンテンツを取得する\n\n### エージェントツール\n\n* `run_agent` : パラメータを指定して登録エージェントを実行する\n* `list_agents` : 利用可能なエージェントとそのメタデータを一覧表示する\n\n### 金融データツール\n\n* **ヤフーファイナンス:**\n\n * `yfinance` : 株価と過去のデータを取得する\n * `yfinance_get_quote` : 現在の株価を取得する\n * `yfinance_get_history` : 過去の株価データを取得する\n * `yfinance_get_info` : 詳細な企業情報を取得する\n * `yfinance_get_options` : オプションチェーンデータを取得する\n * `yfinance_get_recommendations` : アナリストの推奨事項を取得する\n\n* **FRED（連邦準備制度経済データ）：**\n\n * `fred_get_series` : 経済データ系列を取得する\n * `fred_get_series_info` : シリーズに関するメタデータを取得する\n * `fred_search` : 経済データ系列の検索\n * `fred_get_category` : カテゴリ別にデータを閲覧する\n * `fred_get_releases` : 経済データのリリースを取得する\n * `fred_get_sources` : データソースを取得する\n\n### 時間ツール\n\n* `get_current_time` : 指定されたタイムゾーンの現在の時刻を取得する\n* `convert_time` : タイムゾーン間の時間を変換する\n\n### 連続的な思考\n\n* `sequentialthinking` ：段階的な思考プロセスを用いて複雑な問題を分解するためのツール\n\n### 勇敢な検索\n\n* `brave_web_search` : ウェブ検索を実行する\n* `brave_local_search` : 地元のビジネスや場所を検索\n\n### 世界銀行API\n\n* `worldbank_get_indicator` : 国の指標データを取得する\n\n### ニュースAPI\n\n* `news_top_headlines` : トップニュースの見出しを入手\n* `news_search` : ニュース記事を検索\n* `news_sources` : 利用可能なニュースソースを一覧表示する\n\n### PowerPointツール\n\n* `ppt_create_presentation` : 新しいPowerPointプレゼンテーションを作成する\n* `ppt_open_presentation` : 既存のプレゼンテーションを開く\n* `ppt_save_presentation` : プレゼンテーションを保存する\n* `ppt_add_slide` : 新しいスライドを追加する\n* `ppt_add_text` : スライドにテキストを追加する\n* `ppt_add_image` : スライドに画像を追加する\n* `ppt_add_chart` : スライドにグラフを追加する\n* `ppt_add_table` : スライドに表を追加する\n* `ppt_analyze_presentation` : プレゼンテーションの構造を分析する\n* `ppt_enhance_presentation` : 強化策を提案する\n* `ppt_generate_presentation` : テキストからプレゼンテーションを生成する\n* `ppt_command` : 自然言語コマンドを処理する\n\n利用可能なツールの完全なリストについては、ドキュメントを参照するか、ツールディレクトリを参照してください。利用可能なツールの完全なリストについては、ドキュメントを参照するか、ツールディレクトリを参照してください。\n\n### 新しいツールモジュールの追加\n\n1. `tools`ディレクトリに新しいファイルを作成します（例： `my_tool.py` ）\n2. 既存のモジュールパターンに従います。\n * サービスクラスを作成する\n * ツール機能を定義する\n * 登録機能を実装する\n3. `mcp_unified_server.py`を更新して、新しいモジュールをインポートして登録します。\n\n### 既存のツールモジュールの拡張\n\n1. サービスクラスに新しいメソッドを追加する\n2. 新しいツール機能を追加する\n3. 新しいツールを追加するために登録機能を更新します\n\n### Dockerを使った開発\n\n開発に Docker を使用すると、一貫した環境を確保できます。\n\n```bash\n# Build a development image\ndocker build -t mcp-tool-kit:dev .\n\n# Run with source code mounted for development\ndocker run -p 8000:8000 \\\n -v $(pwd):/app \\\n -v ~/documents:/app/documents \\\n mcp-tool-kit:dev\n```\n\nこれにより、ローカルリポジトリがコンテナーにマウントされるため、コードの変更がすぐに反映されます (ほとんどのファイルの場合)。\n\n## 哲学的視点：人間とAIの認知的パートナーシップ\n\nMCPツールキットは、人間の知性とAIシステムの関係性を概念化する上でパラダイムシフトをもたらします。このフレームワークは、AIを単なるタスク自動化ツールとして位置付けるのではなく、人間の戦略的思考とAIの運用能力が深く補完し合う、認知的パートナーシップを構築します。\n\nエージェンティック・アーキテクチャは、変革をもたらすビジョンを体現しています。それは、人間の監視と戦略的指示を維持しながら、自律的に文脈を解釈し、限られたパラメータ内で意思決定を行い、複雑な一連のアクションを実行できるAIシステムです。これは単なる技術進歩ではなく、人間と機械の協働における根本的に新しいモデルです。\n\nこの進化する認知環境において、最も成功する実装は、技術的な可能性と人間の能力を慎重にバランスさせ、人間の意思決定と創造性を置き換えるのではなく、強化するインターフェースを作成することです。\n\n## トラブルシューティング\n\n* **モジュールが読み込まれません**: インポートパスと依存関係を確認してください\n* **APIキーエラー**: `.env`ファイル内のAPIキーを確認してください\n* **権限エラー**: `MCP_FILESYSTEM_DIRS`で許可されたディレクトリを確認してください\n* **接続エラー**: サーバーが実行中であり、ポートにアクセスできることを確認してください\n* **エージェントが検出されません**: エージェントファイルが正しいディレクトリにあり、必要な形式に従っていることを確認してください\n* **パスの問題**: 以下の手順に従って、gitがパスに追加されていることを確認してください。\n\n\\#Windows で Git を PATH に追加するには、次の手順に従います。\n\n1. Git のインストール場所を特定：システム上で Git がインストールされているパスを確認します。一般的なパスは、標準的な Git インストールの場合は C:\\Program Files\\Git\\bin\\git.exe と C:\\Program Files\\Git\\cmd です。GitHub for Windows または GitHub Desktop から Git をインストールした場合は、C:\\Users\\AppData\\Local\\GitHub\\PortableGit\\_\\bin と C:\\Users\\AppData\\Local\\GitHub\\PortableGit\\_\\cmd です。\n\n2. 環境変数の編集：コントロールパネルから、またはスタートメニューで「システム環境変数の編集」を検索して、「環境変数の編集」アプリを開きます。「システム変数」セクションで「Path」変数を見つけ、「編集...」をクリックして、Git実行ファイルとコマンドファイルへのパスを追加します。パスを区切るセミコロンの前後にスペースがないことを確認してください。\n\n3. 変更を保存: Gitパスを追加したら、「OK」をクリックして変更を保存します。コマンドプロンプトウィンドウを閉じて再度開き、新しいPATH設定を適用してください。\n\n4. インストールの確認: コマンドプロンプトを開き、git --version を実行して、コマンドラインから Git にアクセスできることを確認します。\n\n## ライセンス\n\nMCP Unified Server は MIT ライセンスに基づいてライセンスされます。\n\n## 謝辞\n\nこのプロジェクトでは、いくつかのオープンソースライブラリと API を使用します。\n\n* Claude AIアシスタント向けMCP SDK\n* ニュースアクセスのためのNewsAPI\n* ウェブ検索用のBrave Search API\n* 経済データのための世界銀行API\n* PowerPoint 操作用の python-pptx\n* Excelスプレッドシート用のXlsxWriter","Japanese","ja-JP",{"_27":53,"_31":57,"_36":58},{"_29":54,"_31":55,"_33":56},"Claude AI 어시스턴트를 위한 모듈식 서버 구현으로, Claude가 파일 시스템, 웹 검색, 브라우저 자동화, 재무 데이터, 문서 생성과 같은 외부 리소스에 액세스하고 작업을 수행할 수 있도록 하는 통합 도구입니다.","MCP 통합 서버","# MCP 도구 키트\n\n고정밀 수직 AI 에이전트 구축을 위한 모듈식 서버 구현입니다. 고정밀 수직 AI 에이전트 구축에 사용되지만, 배포를 통해 일반 도구 기능에 접근할 수 있습니다.\n\nPython MCP SDK만 사용할 때보다 코드 사용량이 50% 이상 줄었습니다.\n\n[![PyPI 버전](https://img.shields.io/pypi/v/mcptoolkit.svg)](https://pypi.org/project/mcptoolkit/) [![파이썬 버전](https://img.shields.io/pypi/pyversions/mcptoolkit.svg)](https://pypi.org/project/mcptoolkit/) [![특허](https://img.shields.io/github/license/getfounded/mcp-tool-kit.svg)](https://github.com/getfounded/mcp-tool-kit/blob/main/LICENSE)\n\n### 이 접근 방식의 이점\n\n* **Claude의 인지 부하 감소** : Claude는 도구 호출 순서에 대해 추론할 필요가 없습니다.\n* **도메인 지식 캡슐화** : 에이전트는 특정 수직 분야에서 작업을 잘 수행하는 방법에 대한 도메인별 논리를 포함할 수 있습니다.\n* **오류 처리 간소화** : 에이전트는 Claude의 개입 없이 내부적으로 오류를 처리하고 재시도할 수 있습니다.\n* **복잡한 워크플로우 활성화** : 개별 도구 호출을 통해 조정하기 어려운 다단계 프로세스\n* **대화 흐름 유지** : 사용자는 기본 시스템의 복잡성에 노출되지 않습니다.\n\n### 예시 시나리오\n\n클로드가 수직 에이전트를 호출하는 구체적인 예는 다음과 같습니다.\n\n지엑스피1\n\n## 개요\n\nMCP 통합 서버는 Claude가 다음을 포함한 다양한 외부 시스템 및 도구와 상호 작용할 수 있는 통합 인터페이스를 제공합니다.\n\n* **파일 시스템 작업** : 파일 읽기, 쓰기 및 조작\n* **시간 도구** : 다른 시간대의 현재 시간을 가져오고 시간대 간 변환합니다.\n* **순차적 사고** : 역동적이고 반성적인 문제 해결을 위한 도구\n* **Brave Search** : 웹 및 로컬 검색 기능\n* **브라우저 자동화** : Playwright를 통한 완벽한 브라우저 제어\n* **세계은행 API** : 경제 및 개발 데이터 접근\n* **뉴스 API** : 글로벌 뉴스 소스 및 기사에 접근\n* **PowerPoint** : PowerPoint 프레젠테이션 만들기 및 조작\n* **Excel** : Excel 스프레드시트 만들기 및 조작\n* **야후 파이낸스** : 주식 시장 및 금융 데이터\n* **FRED** : 연방준비제도 이사회 경제 데이터\n* **에이전트 기능** : 복잡한 작업을 수행하는 자율 에이전트를 생성하고 배포합니다.\n* **그리고 훨씬 더 많은 전문 도구**\n\n## 총 123개의 도구 사용 가능\n\n![도구를 사용한 클로드 스크린샷](./static/123_tools.png)\n\n## 빠른 시작 가이드: 기본 도구를 사용하여 첫 번째 MCP 서버 배포\n\n참고: git( )과 Docker( )를 다운로드하고 실행 중인지 확인하세요. 또한 git 실행 파일이 path에 추가되었는지 확인해야 합니다(이 README 파일 끝부분에 있는 지침 참조).\n\n## Docker 배포(권장 및 가장 안정적)\n\n1. 저장소를 복제합니다.\n\n```git\nclone https://github.com/getfounded/mcp-tool-kit.git\ncd mcp-tool-kit\n```\n\n2. 그런 다음 두 가지 방법 중 하나로 Docker를 사용할 수 있습니다. 옵션 1 - docker-compose 사용:\n\n```\ndocker-compose up\n```\n\n옵션 2 - 직접 Docker 명령:\n\n```\ndocker run -p 8000:8000 -v ~/documents:/app/documents getfounded/mcp-tool-kit:latest\n```\n\n저장소에는 사용할 수 있는 샘플 Claude 데스크톱 구성 파일( `claude_desktop_config.json` )이 포함되어 있습니다.\n\n```json\n{\n \"mcpServers\": {\n \"unified\": {\n \"command\": \"docker\",\n \"args\": [\n \"exec\",\n \"-i\",\n \"mcp-tool-kit-mcp-server\",\n \"python\",\n \"-u\",\n \"mcp_unified_server.py\"\n ],\n \"useStdio\": true\n }\n }\n}\n```\n\n### 도커 문제 해결\n\nDocker 실행 중 오류가 발생하는 경우, Claude 데스크톱 구성 파일의 이미지 이름이 잘못되었을 가능성이 높습니다. 일반적인 해결 방법은 다음 JSON을 사용하여 구성하는 것입니다.\n\n```json\n{\n \"mcpServers\": {\n \"unified\": {\n \"command\": \"docker\",\n \"args\": [\n \"exec\",\n \"-i\",\n \"mcp-tool-kit-mcp-server-1\",\n \"python\",\n \"-u\",\n \"mcp_unified_server.py\"\n ],\n \"useStdio\": true\n }\n }\n}\n```\n\n## pip를 통해 설치\n\n```bash\n# Simple installation\npip install mcptoolkit\n\n# Launch the server with default configuration\nmcptoolkit-server\n```\n\n로컬 서버 기본 구성:\n\n```json\n{\n \"tools\": [\n {\n \"name\": \"MCP Toolkit\",\n \"url\": \"http://localhost:8000\"\n }\n ],\n \"settings\": {\n \"allowed_directories\": [\"~/Documents\", \"~/Downloads\"],\n \"default_tools\": [\"MCP Toolkit\"]\n }\n}\n```\n\n## Claude Desktop을 구성하여 서버에 액세스하세요\n\n1. Claude 데스크톱 앱 열기\n2. 파일 > 설정 > 개발자 > 구성 편집으로 이동하세요.\n3. 'claude\\_desktop\\_configuration.json' 파일을 추가합니다.\n4. 구성을 저장합니다\n5. 새 도구가 통합된 MCP 서버를 다시 시작하세요.\n6. Claude Desktop 앱을 다시 시작하고 엽니다(Windows 사용자의 경우 작업 관리자를 사용하여 모든 Claude 인스턴스의 작업을 종료해야 함)\n\n이 구성을 Claude 데스크톱 앱으로 가져오거나, 이를 참조하여 사용자 고유의 구성을 만들 수 있습니다.\n\n이제 API 키나 복잡한 설정 없이도 파일 작업, 웹 검색, 시간 도구 등 강력한 기능에 즉시 액세스할 수 있습니다.\n\n## 환경 변수 설정\n\n저장소를 복제한 후에는 환경 변수를 구성하는 데 두 가지 옵션이 있습니다.\n\n### 옵션 1: 대화형 설정 스크립트\n\n환경 변수를 설정하는 방법을 안내하는 설정 스크립트를 실행하세요.\n\n```bash\npython setup_env.py\n```\n\n이 스크립트는 사용자의 구성을 사용하여 저장소에 `.env` 파일을 생성합니다.\n\n### 옵션 2: 수동 구성\n\n또는 다음 변수를 사용하여 저장소 루트에 `.env` 파일을 수동으로 만들 수 있습니다.\n\n```\n# API Keys for external services\nBRAVE_API_KEY=your_brave_api_key\nNEWS_API_KEY=your_news_api_key\nFRED_API_KEY=your_fred_api_key\n\n# Application configuration\nSTREAMLIT_APPS_DIR=/path/to/streamlit/apps\nMCP_FILESYSTEM_DIRS=/path/to/allowed/dir1,/path/to/allowed/dir2\nMCP_LOG_LEVEL=info\n```\n\n### 클로드 프롬프트 샘플\n\n설정이 완료되면 다음과 같은 메시지를 통해 Claude에게 도구 사용을 요청할 수 있습니다.\n\n* \"최신 AI 연구 논문을 웹에서 검색하고 결과를 요약하세요.\"\n* \"세 장의 슬라이드로 기후 변화에 대한 파워포인트 프레젠테이션을 만들어 보세요.\"\n* \"날씨 확인 에이전트를 사용하여 도쿄의 현재 상황을 알려주세요.\"\n* \"Quick\\_Lookup 에이전트를 사용하여 양자 컴퓨팅의 발전에 대해 알아볼 수 있나요?\"\n* \"QuickBooks 송장 데이터를 다운로드하고 지난 분기의 수익을 분석해 보세요.\"\n* \"이러한 세부 정보와 가격으로 Shopify 스토어에 제품을 설정하세요.\"\n* \"Yahoo Finance를 사용하여 Tesla의 현재 주가와 과거 데이터를 확인하세요.\"\n* \"지난 5년간의 FRED 경제 데이터를 사용하여 인플레이션 추세를 분석합니다.\"\n* \"\\[웹사이트 URL]에서 브라우저 자동화를 사용하여 이 양식을 작성하세요.\"\n* \"다운로드 폴더에 있는 'project\\_notes.txt'라는 텍스트 파일을 읽어보세요.\"\n* \"기술에 대한 최신 뉴스 헤드라인을 받아보세요.\"\n\n## 사용 가능한 도구\n\n### 파일 시스템 도구\n\n* `read_file` : 파일의 내용을 읽습니다\n\n* `read_multiple_files` : 여러 파일을 동시에 읽습니다.\n\n* `write_file` : 파일을 생성하거나 덮어씁니다.\n\n* `edit_file` : 파일에 줄 기반 편집을 수행합니다.\n\n* `create_directory` : 새로운 디렉토리를 생성합니다\n\n* `list_directory` : 디렉토리 내용 가져오기\n\n* `directory_tree` : 재귀적 트리 뷰를 가져옵니다\n\n* `move_file` : 파일/디렉토리를 이동하거나 이름을 바꿉니다.\n\n* `search_files` : 패턴과 일치하는 파일을 검색합니다.\n\n* `get_file_info` : 파일 메타데이터 가져오기\n\n* `list_allowed_directories` : 허용된 디렉토리를 나열합니다.\n\n* **브라우저 자동화:**\n\n * `playwright_launch_browser` : 새 브라우저 인스턴스를 시작합니다.\n * `playwright_navigate` : URL로 이동\n * `playwright_screenshot` : 스크린샷 찍기\n * `playwright_click` : 요소를 클릭합니다.\n * `playwright_fill` : 입력 필드 채우기\n * `playwright_evaluate` : JavaScript 실행\n * `playwright_get_content` : 페이지의 HTML 콘텐츠를 가져옵니다\n\n### 에이전트 도구\n\n* `run_agent` : 매개변수를 사용하여 등록된 에이전트를 실행합니다.\n* `list_agents` : 사용 가능한 모든 에이전트와 해당 메타데이터를 나열합니다.\n\n### 재무 데이터 도구\n\n* **야후 파이낸스:**\n\n * `yfinance` : 주식 시세 및 과거 데이터를 받아보세요\n * `yfinance_get_quote` : 현재 주식 시세를 받아보세요\n * `yfinance_get_history` : 과거 주식 데이터 가져오기\n * `yfinance_get_info` : 자세한 회사 정보 얻기\n * `yfinance_get_options` : 옵션 체인 데이터 가져오기\n * `yfinance_get_recommendations` : 분석가 추천 받기\n\n* **FRED(연방준비제도이사회 경제 데이터):**\n\n * `fred_get_series` : 경제 데이터 시리즈 가져오기\n * `fred_get_series_info` : 시리즈에 대한 메타데이터 가져오기\n * `fred_search` : 경제 데이터 시리즈 검색\n * `fred_get_category` : 카테고리별로 데이터 찾아보기\n * `fred_get_releases` : 경제 데이터 발표 받기\n * `fred_get_sources` : 데이터 소스 가져오기\n\n### 시간 도구\n\n* `get_current_time` : 지정된 시간대의 현재 시간을 가져옵니다.\n* `convert_time` : 시간대 간 시간 변환\n\n### 순차적 사고\n\n* `sequentialthinking` : 단계별 사고 과정을 사용하여 복잡한 문제를 분해하는 도구\n\n### 브레이브 서치\n\n* `brave_web_search` : 웹 검색 수행\n* `brave_local_search` : 지역 업체 및 장소 검색\n\n### 세계은행 API\n\n* `worldbank_get_indicator` : 국가별 지표 데이터 가져오기\n\n### 뉴스 API\n\n* `news_top_headlines` : 주요 뉴스 헤드라인을 받아보세요\n* `news_search` : 뉴스 기사 검색\n* `news_sources` : 사용 가능한 뉴스 소스 나열\n\n### 파워포인트 도구\n\n* `ppt_create_presentation` : 새로운 PowerPoint 프레젠테이션을 만듭니다\n* `ppt_open_presentation` : 기존 프레젠테이션을 엽니다\n* `ppt_save_presentation` : 프레젠테이션 저장\n* `ppt_add_slide` : 새 슬라이드 추가\n* `ppt_add_text` : 슬라이드에 텍스트 추가\n* `ppt_add_image` : 슬라이드에 이미지 추가\n* `ppt_add_chart` : 슬라이드에 차트 추가\n* `ppt_add_table` : 슬라이드에 표 추가\n* `ppt_analyze_presentation` : 프레젠테이션 구조 분석\n* `ppt_enhance_presentation` : 개선 사항 제안\n* `ppt_generate_presentation` : 텍스트에서 프레젠테이션을 생성합니다.\n* `ppt_command` : 자연어 명령 처리\n\n사용 가능한 도구의 전체 목록을 보려면 설명서를 참조하거나 도구 디렉터리를 탐색하세요. 사용 가능한 도구의 전체 목록을 보려면 설명서를 참조하거나 도구 디렉터리를 탐색하세요.\n\n### 새로운 도구 모듈 추가\n\n1. `tools` 디렉토리에 새 파일을 만듭니다(예: `my_tool.py` )\n2. 기존 모듈 패턴을 따르세요.\n * 서비스 클래스 생성\n * 도구 기능 정의\n * 등록 기능 구현\n3. `mcp_unified_server.py` 를 업데이트하여 새 모듈을 가져오고 등록하세요.\n\n### 기존 도구 모듈 확장\n\n1. 서비스 클래스에 새로운 메서드 추가\n2. 새로운 도구 기능 추가\n3. 새로운 도구를 포함하도록 등록 기능을 업데이트하세요.\n\n### Docker를 사용한 개발\n\n일관된 환경을 보장하기 위해 개발에 Docker를 사용할 수 있습니다.\n\n```bash\n# Build a development image\ndocker build -t mcp-tool-kit:dev .\n\n# Run with source code mounted for development\ndocker run -p 8000:8000 \\\n -v $(pwd):/app \\\n -v ~/documents:/app/documents \\\n mcp-tool-kit:dev\n```\n\n이렇게 하면 로컬 저장소가 컨테이너에 마운트되므로 코드 변경 사항이 (대부분의 파일에 대해) 즉시 반영됩니다.\n\n## 철학적 관점: 인간-AI 인지 파트너십\n\nMCP 툴킷은 인간 지능과 AI 시스템 간의 관계를 개념화하는 방식에 있어 패러다임의 전환을 보여줍니다. 이 프레임워크는 AI를 단순한 작업 자동화 도구로 보는 것이 아니라, 인간의 전략적 사고와 AI의 운영 역량이 심오한 방식으로 상호 보완되는 인지적 파트너십을 구축합니다.\n\n에이전트 아키텍처는 혁신적인 비전을 구현합니다. AI 시스템은 맥락을 독립적으로 해석하고, 제한된 매개변수 내에서 결정을 내리고, 복잡한 일련의 동작을 실행할 수 있으며, 이 모든 것이 인간의 감독과 전략적 방향을 유지하는 데 도움이 됩니다. 이는 단순한 기술적 진보가 아니라 인간과 기계의 협업을 위한 근본적으로 새로운 모델을 의미합니다.\n\n이처럼 끊임없이 변화하는 인지 환경에서 가장 성공적인 구현은 기술적 잠재력과 인간 능력의 균형을 신중하게 맞춰 인간의 의사 결정과 창의성을 대체하는 것이 아니라 향상시키는 인터페이스를 만드는 것입니다.\n\n## 문제 해결\n\n* **모듈이 로드되지 않음** : 가져오기 경로 및 종속성을 확인하세요\n* **API 키 오류** : `.env` 파일에서 API 키를 확인하세요\n* **권한 오류** : `MCP_FILESYSTEM_DIRS` 에서 허용된 디렉토리를 확인하세요.\n* **연결 오류** : 서버가 실행 중이고 포트에 액세스할 수 있는지 확인하세요.\n* **에이전트가 감지되지 않았습니다** . 에이전트 파일이 올바른 디렉토리에 있고 필요한 형식을 따르는지 확인하세요.\n* **경로 문제** : 아래 지침에 따라 git이 경로에 추가되었는지 확인하세요.\n\n\\#Windows에서 PATH에 Git을 추가하려면 다음 단계를 따르세요.\n\n1. Git 설치 위치 찾기: 시스템에서 Git이 설치된 경로를 확인하세요. 일반적인 경로는 표준 Git 설치의 경우 C:\\Program Files\\Git\\bin\\git.exe와 C:\\Program Files\\Git\\cmd이고, Windows용 GitHub 또는 GitHub Desktop을 통해 Git을 설치한 경우 C:\\Users<사용자 이름>\\AppData\\Local\\GitHub\\PortableGit\\_\\bin과 C:\\Users<사용자 이름>\\AppData\\Local\\GitHub\\PortableGit\\_\\cmd입니다.\n\n2. 환경 변수 편집: 제어판을 통해 또는 시작 메뉴에서 \"시스템 환경 변수 편집\"을 검색하여 \"환경 변수 편집\" 앱을 엽니다. \"시스템 변수\" 섹션에서 \"경로\" 변수를 찾아 \"편집...\"을 클릭하고 Git 실행 파일 및 명령 파일의 경로를 추가합니다. 경로를 구분하는 세미콜론(;) 주위에 공백이 없는지 확인합니다.\n\n3. 변경 사항 저장: Git 경로를 추가한 후 \"확인\"을 클릭하여 변경 사항을 저장합니다. 명령 프롬프트 창을 닫았다가 다시 열어 새 PATH 설정을 적용합니다.\n\n4. 설치 확인: 명령 프롬프트를 열고 git --version을 실행하여 명령줄에서 Git에 접근할 수 있는지 확인합니다.\n\n## 특허\n\nMCP 통합 서버는 MIT 라이선스에 따라 라이선스가 부여됩니다.\n\n## 감사의 말\n\n이 프로젝트는 여러 개의 오픈 소스 라이브러리와 API를 사용합니다.\n\n* Claude AI 어시스턴트를 위한 MCP SDK\n* 뉴스 접근을 위한 NewsAPI\n* 웹 검색을 위한 Brave Search API\n* 세계은행 경제 데이터 API\n* 파워포인트 조작을 위한 python-pptx\n* Excel 스프레드시트용 XlsxWriter","Korean","ko-KR",{"_27":60,"_31":64,"_36":65},{"_29":61,"_31":62,"_33":63},"为 Claude AI 助手提供带有集成工具的模块化服务器实现，使 Claude 能够执行操作并访问外部资源，如文件系统、网络搜索、浏览器自动化、财务数据和文档生成。","MCP统一服务器","# MCP 工具包\n\n用于构建高精度垂直 AI 代理的模块化服务器实现。旨在用于构建高精度垂直 AI 代理，但可以部署以获取常规工具功能。\n\n与单独使用 Python MCP SDK 相比，使用的代码减少了 50% 以上。\n\n[![PyPI 版本](https://img.shields.io/pypi/v/mcptoolkit.svg)](https://pypi.org/project/mcptoolkit/) [![Python 版本](https://img.shields.io/pypi/pyversions/mcptoolkit.svg)](https://pypi.org/project/mcptoolkit/) [![执照](https://img.shields.io/github/license/getfounded/mcp-tool-kit.svg)](https://github.com/getfounded/mcp-tool-kit/blob/main/LICENSE)\n\n### 这种方法的好处\n\n* **减少 Claude 的认知负担**：Claude 不需要推理工具调用的顺序\n* **封装领域知识**：代理可以包含关于如何在特定垂直领域中良好地执行任务的特定领域逻辑\n* **简化错误处理**：代理可以在内部处理错误和重试，无需 Claude 的参与\n* **支持复杂的工作流程**：通过单个工具调用难以协调的多步骤流程\n* **保持对话流程**：用户不会接触到底层系统的复杂性\n\n### 示例场景\n\n以下是克劳德调用垂直代理的具体示例：\n\n```\nUser: \"I need a comprehensive analysis of the electric vehicle market for a presentation tomorrow.\"\n\nClaude: [recognizes this requires multiple tools and domain expertise]\n\nClaude: \"I'll help you with that comprehensive EV market analysis. I'll need to gather the latest market data, news, and trends. This will take a moment...\"\n\n[Behind the scenes, Claude calls a MarketAnalysisAgent]\n\nClaude -> MarketAnalysisAgent.analyze_market(\n sector=\"electric vehicles\",\n include_news=True,\n include_market_data=True,\n create_presentation=True\n)\n\n[The agent orchestrates multiple tool calls using your toolkit]\n- news_search for recent EV news\n- brave_web_search for market data\n- sequential_thinking for analysis\n- write_file to save the report\n- ppt_create_presentation to generate slides\n\n[Agent returns results to Claude]\n\nClaude: \"I've analyzed the electric vehicle market for you. Here are the key findings:\n1. Tesla continues to lead with 65% market share in North America\n2. BYD has overtaken VW in global sales volume\n3. Battery technology breakthroughs are accelerating adoption\n\nI've also created a presentation with detailed charts and data. You can find it saved as 'EV_Market_Analysis.pptx' in your working directory.\"\n```\n\n## 概述\n\nMCP 统一服务器为 Claude 提供了统一的接口，以便与各种外部系统和工具进行交互，包括：\n\n* **文件系统操作**：读取、写入和操作文件\n* **时间工具**：获取不同时区的当前时间，在时区之间进行转换\n* **顺序思维**：动态和反思性解决问题的工具\n* **Brave Search** ：网络和本地搜索功能\n* **浏览器自动化**：通过 Playwright 完成浏览器控制\n* **世界银行 API** ：获取经济和发展数据\n* **新闻 API** ：访问全球新闻来源和文章\n* **PowerPoint** ：创建和操作 PowerPoint 演示文稿\n* **Excel** ：创建和操作 Excel 电子表格\n* **雅虎财经**：股票市场和财务数据\n* **FRED** ：美联储经济数据\n* **代理能力**：创建和部署执行复杂任务的自主代理\n* **还有更多专业工具**\n\n## 总共 123 种可用工具\n\n![Claude 使用工具截图](./static/123_tools.png)\n\n## 快速入门指南：使用默认工具部署您的第一个 MCP 服务器\n\n注意：请确保已下载 git ( ) 和 Docker ( ) 并运行。还必须确保已将 git 可执行文件添加到路径（请参阅本 README 末尾的说明）。\n\n## Docker 部署（推荐且最稳定）\n\n1. 克隆存储库：\n\n```git\nclone https://github.com/getfounded/mcp-tool-kit.git\ncd mcp-tool-kit\n```\n\n2. 然后，您可以通过以下两种方式之一使用 Docker：选项 1 - 使用 docker-compose：\n\n```\ndocker-compose up\n```\n\n选项 2 - 直接 Docker 命令：\n\n```\ndocker run -p 8000:8000 -v ~/documents:/app/documents getfounded/mcp-tool-kit:latest\n```\n\n该存储库包含一个示例 Claude 桌面配置文件（ `claude_desktop_config.json` ），您可以使用它：\n\n```json\n{\n \"mcpServers\": {\n \"unified\": {\n \"command\": \"docker\",\n \"args\": [\n \"exec\",\n \"-i\",\n \"mcp-tool-kit-mcp-server\",\n \"python\",\n \"-u\",\n \"mcp_unified_server.py\"\n ],\n \"useStdio\": true\n }\n }\n}\n```\n\n### docker 故障排除\n\n如果运行 docker 时出现错误，很可能是 Claude 桌面配置文件中的镜像名称不正确。常见的解决方法是使用以下 json 进行配置：\n\n```json\n{\n \"mcpServers\": {\n \"unified\": {\n \"command\": \"docker\",\n \"args\": [\n \"exec\",\n \"-i\",\n \"mcp-tool-kit-mcp-server-1\",\n \"python\",\n \"-u\",\n \"mcp_unified_server.py\"\n ],\n \"useStdio\": true\n }\n }\n}\n```\n\n## 通过 pip 安装\n\n```bash\n# Simple installation\npip install mcptoolkit\n\n# Launch the server with default configuration\nmcptoolkit-server\n```\n\n本地服务器基本配置：\n\n```json\n{\n \"tools\": [\n {\n \"name\": \"MCP Toolkit\",\n \"url\": \"http://localhost:8000\"\n }\n ],\n \"settings\": {\n \"allowed_directories\": [\"~/Documents\", \"~/Downloads\"],\n \"default_tools\": [\"MCP Toolkit\"]\n }\n}\n```\n\n## 配置 Claude Desktop 以访问您的服务器\n\n1. 打开 Claude 桌面应用程序\n2. 转到文件>设置>开发人员>编辑配置\n3. 添加“claude\\_desktop\\_configuration.json”文件\n4. 保存配置\n5. 重启 MCP 服务器并集成新工具\n6. 重新启动并打开 Claude 桌面应用程序（对于 Windows 用户，您必须使用任务管理器来结束所有 Claude 实例的任务）\n\n您可以在 Claude 桌面应用程序中导入此配置，或将其用作参考来创建自己的配置。\n\n您现在可以立即访问强大的功能，包括文件操作、网络搜索、时间工具等，而无需任何 API 密钥或复杂的设置。\n\n## 设置环境变量\n\n克隆存储库后，您有两个选项可以配置环境变量：\n\n### 选项 1：交互式安装脚本\n\n运行安装脚本，它将指导您设置环境变量：\n\n```bash\npython setup_env.py\n```\n\n该脚本将使用您的配置在存储库中创建一个`.env`文件。\n\n### 选项 2：手动配置\n\n或者，您可以使用以下变量在存储库根目录中手动创建`.env`文件：\n\n```\n# API Keys for external services\nBRAVE_API_KEY=your_brave_api_key\nNEWS_API_KEY=your_news_api_key\nFRED_API_KEY=your_fred_api_key\n\n# Application configuration\nSTREAMLIT_APPS_DIR=/path/to/streamlit/apps\nMCP_FILESYSTEM_DIRS=/path/to/allowed/dir1,/path/to/allowed/dir2\nMCP_LOG_LEVEL=info\n```\n\n### 克劳德提示示例\n\n设置完成后，您可以要求 Claude 使用以下提示工具：\n\n* “在网上搜索最新的人工智能研究论文并总结研究结果。”\n* “创建一个包含三张幻灯片的有关气候变化的 PowerPoint 演示文稿。”\n* “使用 weather\\_checker 代理告诉我东京的当前状况。”\n* “您可以使用 quick\\_lookup 代理来研究量子计算的进展吗？”\n* “下载我的 QuickBooks 发票数据并分析我们上个季度的收入。”\n* “使用这些详细信息和定价在我的 Shopify 商店中设置产品。”\n* “使用雅虎财经获取特斯拉的当前股价和历史数据。”\n* “使用过去 5 年的 FRED 经济数据分析通货膨胀趋势。”\n* “使用浏览器自动化功能在 \\[网站网址] 填写此表单。”\n* “阅读我的下载文件夹中名为‘project\\_notes.txt’的文本文件。”\n* “获取有关技术的最新新闻标题。”\n\n## 可用工具\n\n### 文件系统工具\n\n* `read_file` ：读取文件内容\n\n* `read_multiple_files` ：同时读取多个文件\n\n* `write_file` ：创建或覆盖文件\n\n* `edit_file` ：对文件进行基于行的编辑\n\n* `create_directory` ：创建新目录\n\n* `list_directory` ：获取目录内容\n\n* `directory_tree` ：获取递归树视图\n\n* `move_file` ：移动或重命名文件/目录\n\n* `search_files` ：搜索与模式匹配的文件\n\n* `get_file_info` ：获取文件元数据\n\n* `list_allowed_directories` ：列出允许的目录\n\n* **浏览器自动化：**\n\n * `playwright_launch_browser` ：启动新的浏览器实例\n * `playwright_navigate` ：导航到 URL\n * `playwright_screenshot` ：截取屏幕截图\n * `playwright_click` ：点击一个元素\n * `playwright_fill` ：填充输入字段\n * `playwright_evaluate` ：执行 JavaScript\n * `playwright_get_content` ：获取页面的 HTML 内容\n\n### 代理工具\n\n* `run_agent` ：执行带有参数的注册代理\n* `list_agents` ：列出所有可用的代理及其元数据\n\n### 财务数据工具\n\n* **雅虎财经:**\n\n * `yfinance` ：获取股票报价和历史数据\n * `yfinance_get_quote` ：获取当前股票报价\n * `yfinance_get_history` ：获取历史股票数据\n * `yfinance_get_info` ：获取公司详细信息\n * `yfinance_get_options` ：获取期权链数据\n * `yfinance_get_recommendations` ：获取分析师建议\n\n* **FRED（美联储经济数据）：**\n\n * `fred_get_series` ：获取经济数据系列\n * `fred_get_series_info` ：获取有关系列的元数据\n * `fred_search` ：搜索经济数据系列\n * `fred_get_category` ：按类别浏览数据\n * `fred_get_releases` ：获取经济数据发布\n * `fred_get_sources` ：获取数据源\n\n### 时间工具\n\n* `get_current_time` ：获取指定时区的当前时间\n* `convert_time` ：在时区之间转换时间\n\n### 顺序思维\n\n* `sequentialthinking` ：一种使用逐步思考过程分解复杂问题的工具\n\n### 勇敢搜索\n\n* `brave_web_search` ：执行网络搜索\n* `brave_local_search` ：搜索本地商家和地点\n\n### 世界银行应用程序编程接口\n\n* `worldbank_get_indicator` ：获取某个国家的指标数据\n\n### 新闻API\n\n* `news_top_headlines` ：获取头条新闻\n* `news_search` ：搜索新闻文章\n* `news_sources` ：列出可用的新闻来源\n\n### PowerPoint 工具\n\n* `ppt_create_presentation` ：创建一个新的 PowerPoint 演示文稿\n* `ppt_open_presentation` ：打开现有演示文稿\n* `ppt_save_presentation` ：保存演示文稿\n* `ppt_add_slide` ：添加新幻灯片\n* `ppt_add_text` ：向幻灯片添加文本\n* `ppt_add_image` ：向幻灯片添加图像\n* `ppt_add_chart` ：向幻灯片添加图表\n* `ppt_add_table` ：向幻灯片添加表格\n* `ppt_analyze_presentation` ：分析演示文稿结构\n* `ppt_enhance_presentation` ：建议增强功能\n* `ppt_generate_presentation` ：从文本生成演示文稿\n* `ppt_command` ：处理自然语言命令\n\n如需查看可用工具的完整列表，请参阅文档或浏览工具目录。如需查看可用工具的完整列表，请参阅文档或浏览工具目录。\n\n### 添加新工具模块\n\n1. 在`tools`目录中创建一个新文件（例如， `my_tool.py` ）\n2. 遵循现有的模块模式：\n * 创建服务类\n * 定义工具功能\n * 实现注册功能\n3. 更新`mcp_unified_server.py`以导入并注册新模块\n\n### 扩展现有工具模块\n\n1. 向服务类添加新方法\n2. 添加新的工具功能\n3. 更新注册功能以包含您的新工具\n\n### 使用 Docker 进行开发\n\n您可以使用 Docker 进行开发以确保一致的环境：\n\n```bash\n# Build a development image\ndocker build -t mcp-tool-kit:dev .\n\n# Run with source code mounted for development\ndocker run -p 8000:8000 \\\n -v $(pwd):/app \\\n -v ~/documents:/app/documents \\\n mcp-tool-kit:dev\n```\n\n这会将您的本地存储库安装到容器中，因此代码的更改会立即反映出来（对于大多数文件而言）。\n\n## 哲学视角：人机认知伙伴关系\n\nMCP 工具包代表了我们概念化人类智能与人工智能系统之间关系的范式转变。该框架并非将人工智能仅仅定位为任务自动化的工具，而是建立了一种认知伙伴关系，使人类的战略思维与人工智能的运营能力能够深度互补。\n\n代理架构体现了一种变革性的愿景：人工智能系统能够独立解读上下文，在有限的参数范围内做出决策，并执行复杂的动作序列——所有这些都同时保持人类的监督和战略指导。这不仅代表着一项技术进步，更代表着一种全新的人机协作模式。\n\n在这个不断发展的认知领域中，最成功的实现将是那些精心平衡技术潜力和人类能力的实现，创造出增强而不是取代人类决策和创造力的界面。\n\n## 故障排除\n\n* **模块未加载**：检查导入路径和依赖项\n* **API 密钥错误**：在`.env`文件中验证您的 API 密钥\n* **权限错误**：检查`MCP_FILESYSTEM_DIRS`中允许的目录\n* **连接错误**：确保服务器正在运行并且端口可访问\n* **未检测到代理**：验证代理文件是否位于正确的目录中并遵循所需的格式\n* **路径问题**：确保按照以下说明将 git 添加到路径\n\n\\#要将 Git 添加到 Windows 上的 PATH，请按照以下步骤操作：\n\n1. 找到 Git 安装：确定 Git 在系统上的安装路径。常见路径包括：标准 Git 安装的 C:\\Program Files\\Git\\bin\\git.exe 和 C:\\Program Files\\Git\\cmd；如果您通过 Windows 版 GitHub 或 GitHub Desktop 安装 Git，则为 C:\\Users\\AppData\\Local\\GitHub\\PortableGit\\_\\bin 和 C:\\Users\\AppData\\Local\\GitHub\\PortableGit\\_\\cmd。\n\n2. 编辑环境变量：通过控制面板或在“开始”菜单中搜索“编辑系统环境变量”打开“编辑环境变量”应用。在“系统变量”部分下，找到“Path”变量，点击“编辑...”，然后添加 Git 可执行文件和命令文件的路径。确保路径分隔符两边没有空格。\n\n3. 保存更改：添加 Git 路径后，点击“确定”保存更改。关闭并重新打开所有命令提示符窗口，即可应用新的 PATH 设置。\n\n4. 验证安装：打开命令提示符并运行 git --version 以验证是否可以从命令行访问 Git。\n\n## 执照\n\nMCP 统一服务器根据 MIT 许可证获得许可。\n\n## 致谢\n\n该项目使用了几个开源库和 API：\n\n* 适用于 Claude AI 助手的 MCP SDK\n* 用于新闻访问的 NewsAPI\n* 用于网页搜索的 Brave Search API\n* 世界银行经济数据 API\n* python-pptx 用于 PowerPoint 操作\n* Excel 电子表格的 XlsxWriter","Chinese","zh-CN","githubUser","locale",{"_69":70,"_13":71,"_79":30,"_80":30,"_16":81,"_82":83,"_31":32,"_144":145,"_152":153,"_154":155,"_228":229,"_234":-5,"_90":209,"_235":213,"_93":236,"_237":238},"addedAt","2025-03-09T01:01:53.727887Z",[72,73,74,75,76,77,78],"category:agent-orchestration","category:browser-automation","category:developer-tools","environment:local","hosting:hybrid","language:python","license_grade:a","descriptionMarkdown","descriptionPlainText",1693,"integrations",[84,95,102,109,116,123,130,137],{"_85":86,"_29":92,"_93":94},"brand",{"_87":88,"_31":89,"_90":91},"logoSvgPath","M15.68 0l2.096 2.38s1.84-.512 2.709.358c.868.87 1.584 1.638 1.584 1.638l-.562 1.381.715 2.047s-2.104 7.98-2.35 8.955c-.486 1.919-.818 2.66-2.198 3.633-1.38.972-3.884 2.66-4.293 2.916-.409.256-.92.692-1.38.692-.46 0-.97-.436-1.38-.692a185.796 185.796 0 01-4.293-2.916c-1.38-.973-1.712-1.714-2.197-3.633-.247-.975-2.351-8.955-2.351-8.955l.715-2.047-.562-1.381s.716-.768 1.585-1.638c.868-.87 2.708-.358 2.708-.358L8.321 0h7.36zm-3.679 14.936c-.14 0-1.038.317-1.758.69-.72.373-1.242.637-1.409.742-.167.104-.065.301.087.409.152.107 2.194 1.69 2.393 1.866.198.175.489.464.687.464.198 0 .49-.29.688-.464.198-.175 2.24-1.759 2.392-1.866.152-.108.254-.305.087-.41-.167-.104-.689-.368-1.41-.741-.72-.373-1.617-.69-1.757-.69zm0-11.278s-.409.001-1.022.206-1.278.46-1.584.46c-.307 0-2.581-.434-2.581-.434S4.119 7.152 4.119 7.849c0 .697.339.881.68 1.243l2.02 2.149c.192.203.59.511.356 1.066-.235.555-.58 1.26-.196 1.977.384.716 1.042 1.194 1.464 1.115.421-.08 1.412-.598 1.776-.834.364-.237 1.518-1.19 1.518-1.554 0-.365-1.193-1.02-1.413-1.168-.22-.15-1.226-.725-1.247-.95-.02-.227-.012-.293.284-.851.297-.559.831-1.304.742-1.8-.089-.495-.95-.753-1.565-.986-.615-.232-1.799-.671-1.947-.74-.148-.068-.11-.133.339-.175.448-.043 1.719-.212 2.292-.052.573.16 1.552.403 1.632.532.079.13.149.134.067.579-.081.445-.5 2.581-.541 2.96-.04.38-.12.63.288.724.409.094 1.097.256 1.333.256s.924-.162 1.333-.256c.408-.093.329-.344.288-.723-.04-.38-.46-2.516-.541-2.961-.082-.445-.012-.45.067-.579.08-.129 1.059-.372 1.632-.532.573-.16 1.845.009 2.292.052.449.042.487.107.339.175-.148.069-1.332.508-1.947.74-.615.233-1.476.49-1.565.986-.09.496.445 1.241.742 1.8.297.558.304.624.284.85-.02.226-1.026.802-1.247.95-.22.15-1.413.804-1.413 1.169 0 .364 1.154 1.317 1.518 1.554.364.236 1.355.755 1.776.834.422.079 1.08-.4 1.464-1.115.384-.716.039-1.422-.195-1.977-.235-.555.163-.863.355-1.066l2.02-2.149c.341-.362.68-.546.68-1.243 0-.697-2.695-3.96-2.695-3.96s-2.274.436-2.58.436c-.307 0-.972-.256-1.585-.461-.613-.205-1.022-.206-1.022-.206z","Brave","slug","brave","Provides web search capabilities through Brave Search API","uid","2uooimlvg1",{"_85":96,"_29":100,"_93":101},{"_87":97,"_31":98,"_90":99},"M13.983 11.078h2.119a.186.186 0 00.186-.185V9.006a.186.186 0 00-.186-.186h-2.119a.185.185 0 00-.185.185v1.888c0 .102.083.185.185.185m-2.954-5.43h2.118a.186.186 0 00.186-.186V3.574a.186.186 0 00-.186-.185h-2.118a.185.185 0 00-.185.185v1.888c0 .102.082.185.185.185m0 2.716h2.118a.187.187 0 00.186-.186V6.29a.186.186 0 00-.186-.185h-2.118a.185.185 0 00-.185.185v1.887c0 .102.082.185.185.186m-2.93 0h2.12a.186.186 0 00.184-.186V6.29a.185.185 0 00-.185-.185H8.1a.185.185 0 00-.185.185v1.887c0 .102.083.185.185.186m-2.964 0h2.119a.186.186 0 00.185-.186V6.29a.185.185 0 00-.185-.185H5.136a.186.186 0 00-.186.185v1.887c0 .102.084.185.186.186m5.893 2.715h2.118a.186.186 0 00.186-.185V9.006a.186.186 0 00-.186-.186h-2.118a.185.185 0 00-.185.185v1.888c0 .102.082.185.185.185m-2.93 0h2.12a.185.185 0 00.184-.185V9.006a.185.185 0 00-.184-.186h-2.12a.185.185 0 00-.184.185v1.888c0 .102.083.185.185.185m-2.964 0h2.119a.185.185 0 00.185-.185V9.006a.185.185 0 00-.184-.186h-2.12a.186.186 0 00-.186.186v1.887c0 .102.084.185.186.185m-2.92 0h2.12a.185.185 0 00.184-.185V9.006a.185.185 0 00-.184-.186h-2.12a.185.185 0 00-.184.185v1.888c0 .102.082.185.185.185M23.763 9.89c-.065-.051-.672-.51-1.954-.51-.338.001-.676.03-1.01.087-.248-1.7-1.653-2.53-1.716-2.566l-.344-.199-.226.327c-.284.438-.49.922-.612 1.43-.23.97-.09 1.882.403 2.661-.595.332-1.55.413-1.744.42H.751a.751.751 0 00-.75.748 11.376 11.376 0 00.692 4.062c.545 1.428 1.355 2.48 2.41 3.124 1.18.723 3.1 1.137 5.275 1.137.983.003 1.963-.086 2.93-.266a12.248 12.248 0 003.823-1.389c.98-.567 1.86-1.288 2.61-2.136 1.252-1.418 1.998-2.997 2.553-4.4h.221c1.372 0 2.215-.549 2.68-1.009.309-.293.55-.65.707-1.046l.098-.288Z","Docker","docker","Provides containerized deployment of the MCP server","r6h8jd4x6i",{"_85":103,"_29":107,"_93":108},{"_87":104,"_31":105,"_90":106},"M23.546 10.93L13.067.452c-.604-.603-1.582-.603-2.188 0L8.708 2.627l2.76 2.76c.645-.215 1.379-.07 1.889.441.516.515.658 1.258.438 1.9l2.658 2.66c.645-.223 1.387-.078 1.9.435.721.72.721 1.884 0 2.604-.719.719-1.881.719-2.6 0-.539-.541-.674-1.337-.404-1.996L12.86 8.955v6.525c.176.086.342.203.488.348.713.721.713 1.883 0 2.6-.719.721-1.889.721-2.609 0-.719-.719-.719-1.879 0-2.598.182-.18.387-.316.605-.406V8.835c-.217-.091-.424-.222-.6-.401-.545-.545-.676-1.342-.396-2.009L7.636 3.7.45 10.881c-.6.605-.6 1.584 0 2.189l10.48 10.477c.604.604 1.582.604 2.186 0l10.43-10.43c.605-.603.605-1.582 0-2.187","Git","git","Used for cloning the repository and version control","me7zubypfy",{"_85":110,"_29":114,"_93":115},{"_87":111,"_31":112,"_90":113},"M14.25.18l.9.2.73.26.59.3.45.32.34.34.25.34.16.33.1.3.04.26.02.2-.01.13V8.5l-.05.63-.13.55-.21.46-.26.38-.3.31-.33.25-.35.19-.35.14-.33.1-.3.07-.26.04-.21.02H8.77l-.69.05-.59.14-.5.22-.41.27-.33.32-.27.35-.2.36-.15.37-.1.35-.07.32-.04.27-.02.21v3.06H3.17l-.21-.03-.28-.07-.32-.12-.35-.18-.36-.26-.36-.36-.35-.46-.32-.59-.28-.73-.21-.88-.14-1.05-.05-1.23.06-1.22.16-1.04.24-.87.32-.71.36-.57.4-.44.42-.33.42-.24.4-.16.36-.1.32-.05.24-.01h.16l.06.01h8.16v-.83H6.18l-.01-2.75-.02-.37.05-.34.11-.31.17-.28.25-.26.31-.23.38-.2.44-.18.51-.15.58-.12.64-.1.71-.06.77-.04.84-.02 1.27.05zm-6.3 1.98l-.23.33-.08.41.08.41.23.34.33.22.41.09.41-.09.33-.22.23-.34.08-.41-.08-.41-.23-.33-.33-.22-.41-.09-.41.09zm13.09 3.95l.28.06.32.12.35.18.36.27.36.35.35.47.32.59.28.73.21.88.14 1.04.05 1.23-.06 1.23-.16 1.04-.24.86-.32.71-.36.57-.4.45-.42.33-.42.24-.4.16-.36.09-.32.05-.24.02-.16-.01h-8.22v.82h5.84l.01 2.76.02.36-.05.34-.11.31-.17.29-.25.25-.31.24-.38.2-.44.17-.51.15-.58.13-.64.09-.71.07-.77.04-.84.01-1.27-.04-1.07-.14-.9-.2-.73-.25-.59-.3-.45-.33-.34-.34-.25-.34-.16-.33-.1-.3-.04-.25-.02-.2.01-.13v-5.34l.05-.64.13-.54.21-.46.26-.38.3-.32.33-.24.35-.2.35-.14.33-.1.3-.06.26-.04.21-.02.13-.01h5.84l.69-.05.59-.14.5-.21.41-.28.33-.32.27-.35.2-.36.15-.36.1-.35.07-.32.04-.28.02-.21V6.07h2.09l.14.01zm-6.47 14.25l-.23.33-.08.41.08.41.23.33.33.23.41.08.41-.08.33-.23.23-.33.08-.41-.08-.41-.23-.33-.33-.23-.41-.08-.41.08z","Python","python","Used as the implementation language for the MCP server and custom tools","31aqap67fb",{"_85":117,"_29":121,"_93":122},{"_87":118,"_31":119,"_90":120},"M12 0A12 12 0 0 0 0 12a12 12 0 0 0 12 12 12 12 0 0 0 12-12A12 12 0 0 0 12 0zm.642 4.1335c.9554 0 1.7296.776 1.7296 1.7332v9.0667h1.6c1.614 0 2.9275-1.3156 2.9275-2.933 0-1.6173-1.3136-2.9333-2.9276-2.9333h-.6654V7.3334h.6654c2.5722 0 4.6577 2.0897 4.6577 4.667 0 2.5774-2.0855 4.6666-4.6577 4.6666H12.642zM7.9837 7.333h3.3291v12.533c-.9555 0-1.73-.7759-1.73-1.7332V9.0662H7.9837c-1.6146 0-2.9277 1.316-2.9277 2.9334 0 1.6175 1.3131 2.9333 2.9277 2.9333h.6654v1.7332h-.6654c-2.5725 0-4.6577-2.0892-4.6577-4.6665 0-2.5771 2.0852-4.6666 4.6577-4.6666Z","QuickBooks","quickbooks","Mentioned as a data source that can be accessed through the MCP toolkit","cw5slhvmpg",{"_85":124,"_29":128,"_93":129},{"_87":125,"_31":126,"_90":127},"M15.337 23.979l7.216-1.561s-2.604-17.613-2.625-17.73c-.018-.116-.114-.192-.211-.192s-1.929-.136-1.929-.136-1.275-1.274-1.439-1.411c-.045-.037-.075-.057-.121-.074l-.914 21.104h.023zM11.71 11.305s-.81-.424-1.774-.424c-1.447 0-1.504.906-1.504 1.141 0 1.232 3.24 1.715 3.24 4.629 0 2.295-1.44 3.76-3.406 3.76-2.354 0-3.54-1.465-3.54-1.465l.646-2.086s1.245 1.066 2.28 1.066c.675 0 .975-.545.975-.932 0-1.619-2.654-1.694-2.654-4.359-.034-2.237 1.571-4.416 4.827-4.416 1.257 0 1.875.361 1.875.361l-.945 2.715-.02.01zM11.17.83c.136 0 .271.038.405.135-.984.465-2.064 1.639-2.508 3.992-.656.213-1.293.405-1.889.578C7.697 3.75 8.951.84 11.17.84V.83zm1.235 2.949v.135c-.754.232-1.583.484-2.394.736.466-1.777 1.333-2.645 2.085-2.971.193.501.309 1.176.309 2.1zm.539-2.234c.694.074 1.141.867 1.429 1.755-.349.114-.735.231-1.158.366v-.252c0-.752-.096-1.371-.271-1.871v.002zm2.992 1.289c-.02 0-.06.021-.078.021s-.289.075-.714.21c-.423-1.233-1.176-2.37-2.508-2.37h-.115C12.135.209 11.669 0 11.265 0 8.159 0 6.675 3.877 6.21 5.846c-1.194.365-2.063.636-2.16.674-.675.213-.694.232-.772.87-.075.462-1.83 14.063-1.83 14.063L15.009 24l.927-21.166z","Shopify","shopify","Mentioned as a platform that can be controlled through the MCP toolkit","y4hhebayq0",{"_85":131,"_29":135,"_93":136},{"_87":132,"_31":133,"_90":134},"M16.673 11.32l6.862-3.618c.233-.136.554.12.442.387L20.463 17.1zm-8.556-.229l3.473-5.187c.203-.328.578-.316.793-.028l7.886 11.75zm-3.375 7.25c-.28 0-.835-.284-.993-.716l-3.72-9.46c-.118-.331.139-.614.48-.464l19.474 10.306c-.149.147-.453.337-.72.334z","Streamlit","streamlit","Provides a web-based configuration UI for the MCP toolkit","15lkhks8n5",{"_85":138,"_29":142,"_93":143},{"_87":139,"_31":140,"_90":141},"M12 5.362l2.475-3.026s4.245.09 8.471 2.054c-1.082 1.636-3.231 2.438-3.231 2.438-.146-1.439-1.154-1.79-4.354-1.79L12 24 8.619 5.034c-3.18 0-4.188.354-4.335 1.792 0 0-2.146-.795-3.229-2.43C5.28 2.431 9.525 2.34 9.525 2.34L12 5.362l-.004.002H12v-.002zm0-3.899c3.415-.03 7.326.528 11.328 2.28.535-.968.672-1.395.672-1.395C19.625.612 15.528.015 12 0 8.472.015 4.375.61 0 2.349c0 0 .195.525.672 1.396C4.674 1.989 8.585 1.435 12 1.46v.003z","Tesla","tesla","Referenced in example queries for stock data analysis through Yahoo Finance integration","g74x83i7qx","namespace",{"_146":147,"_90":151},"owner",{"_148":149},"githubAccount",{"_150":151},"login","getfounded","redditPostExternalId","1jatnu1","repository",{"_156":157,"_194":195,"_199":200,"_219":-5,"_220":221,"_222":-5,"_223":224},"argumentsJsonSchema",{"_158":159,"_191":192,"_165":193},"properties",{"_160":161,"_167":168,"_171":172,"_174":175,"_177":178,"_181":182,"_184":185,"_188":189},"MCP_HOST",{"_162":163,"_29":164,"_165":166},"default","0.0.0.0","Host address for the MCP server","type","string","MCP_PORT",{"_162":169,"_29":170,"_165":166},"8000","Port for the MCP server","NEWS_API_KEY",{"_29":173,"_165":166},"API key for News API","BRAVE_API_KEY",{"_29":176,"_165":166},"API key for Brave Search","MCP_LOG_LEVEL",{"_162":179,"_29":180,"_165":166},"info","Logging level (debug, info, warning, error)","BROWSERBASE_API_KEY",{"_29":183,"_165":166},"API key for Browserbase","MCP_FILESYSTEM_DIRS",{"_162":186,"_29":187,"_165":166},"~/documents,~/downloads","Comma-separated list of allowed directories","BROWSERBASE_PROJECT_ID",{"_29":190,"_165":166},"Project ID for Browserbase","required",[],"object","githubProject",{"_33":196,"_197":198},"# MCP Tool Kit\n\nA comprehensive toolkit for the Model Context Protocol (MCP) with automatic tool discovery and multiple transport options.\n\n[![PyPI version](https://img.shields.io/pypi/v/mcptoolkit.svg)](https://pypi.org/project/mcptoolkit/)\n[![Python versions](https://img.shields.io/pypi/pyversions/mcptoolkit.svg)](https://pypi.org/project/mcptoolkit/)\n[![License](https://img.shields.io/github/license/getfounded/mcp-tool-kit.svg)](https://github.com/getfounded/mcp-tool-kit/blob/main/LICENSE)\n\n📚 **[Official Documentation](https://docs.mcp-tool-kit.com)** | 🌐 **[Website](https://mcp-tool-kit.com)** | 💬 **[Community](https://github.com/getfounded/mcp-tool-kit/discussions)**\n\n---\n\n🚀 **Built by [UsefulAI](https://usefulai.ai)** | 📖 **[From GitHub to Commercial Success](https://usefulai.ai/blog/articles/from-github-to-commercial-success)**\n\n## 🚀 Quick Install - No Git Required!\n\nChoose your platform and run ONE command:\n\n### 🖥️ Windows (PowerShell)\n```powershell\nirm https://raw.githubusercontent.com/getfounded/mcp-tool-kit/main/install.ps1 | iex\n```\n\n### 🍎 macOS (Terminal)\n```bash\nbash <(curl -s https://raw.githubusercontent.com/getfounded/mcp-tool-kit/main/install.sh)\n```\n\n### 🐧 Linux (Terminal)\n```bash\nbash <(wget -qO- https://raw.githubusercontent.com/getfounded/mcp-tool-kit/main/install.sh)\n```\n\n**That's it!** The installer will:\n- ✅ Download MCP Tool Kit (no Git needed!)\n- ✅ Check for Docker (helps install if missing)\n- ✅ Create desktop shortcuts\n- ✅ Set up everything automatically\n\n## 📦 Alternative Installation Methods\n\n

Manual Download

\n\n1. Download the latest release:\n - [Windows: MCP-Tool-Kit-Windows.zip](https://github.com/getfounded/mcp-tool-kit/releases/latest)\n - [Mac/Linux: MCP-Tool-Kit-Unix.tar.gz](https://github.com/getfounded/mcp-tool-kit/releases/latest)\n\n2. Extract and run:\n - **Windows**: Run `install.bat`\n - **Mac/Linux**: Run `./install.sh`\n

\n\n

Git Installation (for developers)

\n\n1. **Clone the repository**\n ```bash\n git clone https://github.com/getfounded/mcp-tool-kit.git\n cd mcp-tool-kit\n ```\n\n2. **Run the launcher**\n - **Windows**: Double-click `launch.bat`\n - **Mac/Linux**: Run `./launch.sh`\n

\n\n

Docker-Only Installation

\n\n```bash\ndocker run -it --name mcp-toolkit ghcr.io/getfounded/mcp-tool-kit:latest\n```\n

\n\n## 🔧 Features\n\n### Dynamic Tool Registration\nTools are automatically discovered and registered at runtime - no manual configuration needed!\n\n### Multiple Transport Options\n- **stdio**: For Claude Desktop integration\n- **SSE (Server-Sent Events)**: For web-based access\n\n### 120+ Available Tools\n- 📁 **File System**: Read, write, and manage files\n- 🕐 **Time Tools**: Timezone conversions and time operations\n- 🌐 **Web Search**: Brave Search integration\n- 🤖 **Browser Automation**: Playwright-based browser control\n- 📊 **Data Analysis**: Yahoo Finance, FRED, World Bank data\n- 📄 **Document Tools**: PDF, Excel, PowerPoint manipulation\n- 🎯 **And many more!**\n\n### Easy Configuration\nControl everything through a simple `config.yaml` file:\n\n```yaml\nenabled_tools:\n filesystem: true\n time_tools: true\n brave_search: true\n # ... more tools\n\ntool_config:\n filesystem:\n allowed_directories: [\"~/Documents\", \"~/Downloads\"]\n brave_search:\n max_results: 10\n```\n\n## 📋 Environment Setup\n\n1. Copy `.env.template` to `.env`\n2. Add your API keys:\n ```env\n BRAVE_SEARCH_API_KEY=your_key_here\n NEWS_API_KEY=your_key_here\n FRED_API_KEY=your_key_here\n # ... other keys\n ```\n\n## 💾 Storage Setup\n\nMCP Tool Kit uses a dedicated storage directory for file operations:\n\n- **Windows**: `C:\\Users\\{Username}\\mcp-tool-kit-storage`\n- **Mac/Linux**: `~/mcp-tool-kit-storage`\n\n### Automatic Setup\nThe storage directory is automatically created when you first run the Docker container. You can also manually set it up:\n\n**Windows (PowerShell)**:\n```powershell\n.\\scripts\\setup-storage.ps1\n```\n\n**Mac/Linux**:\n```bash\n./scripts/setup-storage.sh\n```\n\n### Storage Structure\n```\nmcp-tool-kit-storage/\n├── documents/ # For document files\n├── downloads/ # For downloaded files\n└── workspace/ # For temporary work files\n```\n\nAll file operations through the filesystem tool will be restricted to this directory for security.\n\n## 🔌 Connecting to Claude Desktop\n\n1. Start the server in stdio mode using the launcher\n2. Add to Claude Desktop configuration:\n ```json\n {\n \"mcpServers\": {\n \"mcp-tool-kit\": {\n \"command\": \"docker\",\n \"args\": [\"exec\", \"-i\", \"mcp-server\", \"python\", \"mcp_server_v2.py\"]\n }\n }\n }\n ```\n\n## 🌐 Using SSE Mode\n\n1. Start the server in SSE mode using the launcher\n2. Access the server at `http://localhost:8080`\n3. Use the SSE endpoints:\n - `/sse` - Server-Sent Events stream\n - `/messages` - Send messages to the server\n\n## 🛠️ Creating Custom Tools\n\nTools now use a standardized base class system:\n\n```python\nfrom app.tools.base_tool import BaseTool\n\nclass MyCustomTool(BaseTool):\n def get_name(self) -> str:\n return \"My Custom Tool\"\n \n def get_tools(self) -> Dict[str, Callable]:\n return {\n \"my_function\": self.my_function\n }\n \n async def my_function(self, param: str, ctx: Context = None) -> str:\n return f\"Processed: {param}\"\n```\n\nSee the [developer documentation](https://docs.mcp-tool-kit.com) for detailed guides.\n\n## 📚 Documentation\n\nFull documentation is available at [https://docs.mcp-tool-kit.com](https://docs.mcp-tool-kit.com).\n\nTo run documentation locally:\n1. `cd docs`\n2. `npm install`\n3. `npm start`\n\n## 🐳 Docker Commands\n\n### Using the Launcher (Recommended)\nThe launcher scripts handle all Docker operations automatically.\n\n### Manual Commands\n```bash\n# Start server\ndocker-compose up -d\n\n# View logs\ndocker-compose logs -f\n\n# Stop server\ndocker-compose down\n\n# Rebuild after changes\ndocker-compose build --no-cache\n```\n\n## 🤝 Contributing\n\n1. Fork the repository\n2. Create your feature branch\n3. Add your tool to `app/tools/`\n4. Submit a pull request\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the LICENSE file for details.\n\n## 🆘 Support\n\n- [GitHub Issues](https://github.com/getfounded/mcp-tool-kit/issues)\n- [Documentation](https://docs.mcp-tool-kit.com)\n- [Discord Community](#) (coming soon)","url","https://github.com/getfounded/mcp-tool-kit","githubRepository",{"_201":202,"_203":204,"_205":206,"_16":207,"_208":112,"_31":209,"_146":210,"_212":213,"_214":215,"_217":218},"defaultBranch","main","fullName","getfounded/mcp-tool-kit","githubTreeId",355695,2376,"language","mcp-tool-kit",{"_150":151,"_93":211},"o2T9MNJMiD","recentStargazers",0,"spdxLicense",{"_31":216},"MIT License","stargazers",95,"glamaJson","inspectable",false,"npmPackage","supportedPlatforms",[225,226,227],"WINDOWS","LINUX","MACOS","scores",{"_230":231,"_232":-5,"_233":-5},"license",100,"quality","security","simpleIcon","toolCount","yghl2ut3cx","updatedAt","2025-09-20T04:40:20.864618Z","meta",[241,244,246,253,256,258,261,264,267,270,273,275,278,281,283,285,287,289,291],{"_242":243},"title","MCP Unified Server | Glama",{"_245":30,"_31":29},"content",{"_247":248,"_249":250,"_251":252},"href","https://glama.ai/mcp/servers/@getfounded/mcp-tool-kit","rel","canonical","tagName","link",{"_245":32,"_254":255},"property","og:title",{"_245":30,"_254":257},"og:description",{"_245":259,"_254":260},"https://glama.ai/logo.png","og:logo",{"_245":262,"_254":263},"https://glama.ai/mcp/servers/@getfounded/mcp-tool-kit/og-image","og:image",{"_245":265,"_254":266},"630","og:image:height",{"_245":268,"_254":269},"1200","og:image:width",{"_245":271,"_254":272},"website","og:type",{"_245":248,"_254":274},"og:url",{"_245":276,"_254":277},"Glama – MCP Hosting Platform","og:site_name",{"_245":279,"_31":280},"summary_large_image","twitter:card",{"_245":276,"_31":282},"twitter:title",{"_245":30,"_31":284},"twitter:description",{"_245":262,"_31":286},"twitter:image",{"_245":265,"_31":288},"twitter:image:height",{"_245":268,"_31":290},"twitter:image:width",{"_292":293},"script:ld+json",{"_294":295,"_296":297},"@context","http://schema.org","@graph",[298],{"_294":299,"_300":301,"_302":303},"https://schema.org","@type","BreadcrumbList","itemListElement",[304,311,315,319],{"_300":305,"_306":307,"_31":308,"_309":310},"ListItem","item","/","Glama","position",1,{"_300":305,"_306":312,"_31":313,"_309":314},"/mcp","MCP",2,{"_300":305,"_306":316,"_31":317,"_309":318},"/mcp/servers","Servers",3,{"_300":305,"_306":320,"_31":32,"_309":321},"/mcp/servers/@getfounded/mcp-tool-kit",4,"visitorIsMaintainer","routes/_public/mcp/servers/~namespace/~slug/_pages/_explorer/blob/~commit/~/_route",{"_325":326,"_27":332,"_372":373,"_239":387,"_385":411,"_412":413},"blob",{"_245":327,"_328":329,"_330":331},"","fileName","logo.svg","size",427,{"_69":70,"_13":333,"_79":30,"_80":30,"_16":81,"_82":334,"_31":32,"_144":351,"_152":153,"_154":354,"_228":371,"_234":-5,"_90":209,"_235":213,"_93":236,"_237":238},[72,73,74,75,76,77,78],[335,337,339,341,343,345,347,349],{"_85":336,"_29":92,"_93":94},{"_87":88,"_31":89,"_90":91},{"_85":338,"_29":100,"_93":101},{"_87":97,"_31":98,"_90":99},{"_85":340,"_29":107,"_93":108},{"_87":104,"_31":105,"_90":106},{"_85":342,"_29":114,"_93":115},{"_87":111,"_31":112,"_90":113},{"_85":344,"_29":121,"_93":122},{"_87":118,"_31":119,"_90":120},{"_85":346,"_29":128,"_93":129},{"_87":125,"_31":126,"_90":127},{"_85":348,"_29":135,"_93":136},{"_87":132,"_31":133,"_90":134},{"_85":350,"_29":142,"_93":143},{"_87":139,"_31":140,"_90":141},{"_146":352,"_90":151},{"_148":353},{"_150":151},{"_156":355,"_194":366,"_199":367,"_219":-5,"_220":221,"_222":-5,"_223":370},{"_158":356,"_191":365,"_165":193},{"_160":357,"_167":358,"_171":359,"_174":360,"_177":361,"_181":362,"_184":363,"_188":364},{"_162":163,"_29":164,"_165":166},{"_162":169,"_29":170,"_165":166},{"_29":173,"_165":166},{"_29":176,"_165":166},{"_162":179,"_29":180,"_165":166},{"_29":183,"_165":166},{"_162":186,"_29":187,"_165":166},{"_29":190,"_165":166},[],{"_33":196,"_197":198},{"_201":202,"_203":204,"_205":206,"_16":207,"_208":112,"_31":209,"_146":368,"_212":213,"_214":369,"_217":218},{"_150":151,"_93":211},{"_31":216},[225,226,227],{"_230":231,"_232":-5,"_233":-5},"member",{"_374":375,"_378":379,"_380":381,"_205":382,"_383":384,"_385":329,"_386":384,"_330":331,"_165":325},"commit",{"_376":377},"sha","59e584e1d7eb28c3f2cdd10a5c70760d0484e76a","contentStoredObjectPointerId",510653,"fullPath","docs/static/img/logo.svg",355686,"indexable",true,"path","safeToDisplayAsText",[388,390,392,394,396,397,398,400,401,402,403,404,405,406,407,408,409,410],{"_242":389},"logo.svg | MCP Unified Server | Glama",{"_245":391,"_31":29},"Enterprise-grade security, privacy, and features like agents, MCP, prompt templates, and more.",{"_247":393,"_249":250,"_251":252},"https://glama.ai/mcp/servers/@getfounded/mcp-tool-kit/blob/59e584e1d7eb28c3f2cdd10a5c70760d0484e76a/docs/static/img",{"_245":395,"_254":255},"logo.svg | MCP Unified Server",{"_245":391,"_254":257},{"_245":259,"_254":260},{"_245":399,"_254":263},"https://glama.ai/generated-images/og?title=logo.svg+%7C+MCP+Unified+Server",{"_245":265,"_254":266},{"_245":268,"_254":269},{"_245":271,"_254":272},{"_245":393,"_254":274},{"_245":276,"_254":277},{"_245":279,"_31":280},{"_245":276,"_31":282},{"_245":391,"_31":284},{"_245":399,"_31":286},{"_245":265,"_31":288},{"_245":268,"_31":290},"docs/static/img","treeMembers",[414],{"_374":415,"_380":381,"_385":329,"_165":325},{"_376":377},"actionData","errors"]

MCP directory API