{"id":29092394,"url":"https://github.com/parisneo/parisneomcpservers","last_synced_at":"2025-10-16T03:51:09.381Z","repository":{"id":298022938,"uuid":"998480076","full_name":"ParisNeo/PArisNeoMCPServers","owner":"ParisNeo","description":"A list of useful MCP servers built  for the community","archived":false,"fork":false,"pushed_at":"2025-06-23T09:58:52.000Z","size":168,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-23T10:47:17.159Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ParisNeo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-08T17:40:35.000Z","updated_at":"2025-06-23T09:58:56.000Z","dependencies_parsed_at":"2025-06-09T01:29:57.993Z","dependency_job_id":"7af13f6e-a9ed-4f58-ab18-905801ce56a5","html_url":"https://github.com/ParisNeo/PArisNeoMCPServers","commit_stats":null,"previous_names":["parisneo/parisneomcpservers"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ParisNeo/PArisNeoMCPServers","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ParisNeo%2FPArisNeoMCPServers","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ParisNeo%2FPArisNeoMCPServers/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ParisNeo%2FPArisNeoMCPServers/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ParisNeo%2FPArisNeoMCPServers/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ParisNeo","download_url":"https://codeload.github.com/ParisNeo/PArisNeoMCPServers/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ParisNeo%2FPArisNeoMCPServers/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262389478,"owners_count":23303343,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-06-28T07:06:41.387Z","updated_at":"2025-10-16T03:51:04.345Z","avatar_url":"https://github.com/ParisNeo.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# PArisNeoMCPServers\n\n[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)\n[![Python Version](https://img.shields.io/badge/python-3.9%2B-brightgreen.svg)](https://www.python.org/)\n[![MCP Standard](https://img.shields.io/badge/MCP-Compliant-orange)](https://github.com/ParisNeo/mcp_standard) \u003c!-- Replace with actual MCP standard link if available --\u003e\n[![Contributions Welcome](https://img.shields.io/badge/contributions-welcome-brightgreen.svg?style=flat)](CONTRIBUTING.md) \u003c!-- Assuming a CONTRIBUTING.md will exist --\u003e\n\n**A curated collection of versatile and useful MCP (Model Context Protocol) servers designed to extend the capabilities of Large Language Models.**\n\nThis repository hosts a growing suite of MCP servers, each providing distinct functionalities that LLMs can leverage through the Model Context Protocol. These servers enable LLMs to interact with external tools, APIs, and information sources in a standardized way.\n\n## What is MCP?\n\nThe Model Context Protocol (MCP) is a specification that allows Large Language Models to communicate with external tools and services. It defines a standard way for LLMs to request actions, send parameters, and receive results, effectively expanding their operational range beyond text generation. MCP servers act as bridges, exposing various capabilities as \"tools\" that MCP-compliant LLM clients (like [LollmsClient](https://github.com/ParisNeo/lollms-client)) can discover and utilize.\n\n## Available MCP Servers\n\nThis collection currently includes the following MCP servers:\n\n1.  ### 🔵 OpenAI MCP Server (`openai-mcp-server`)\n    *   **Description**: Integrates with various OpenAI APIs.\n    *   **Current Tools**:\n        *   `generate_tts`: Text-to-Speech generation using OpenAI's TTS models (e.g., `tts-1`, `tts-1-hd`).\n        *   `generate_image_dalle`: Image generation using OpenAI's DALL-E models (e.g., `dall-e-2`, `dall-e-3`).\n        *   *(Chat completion tool was part of its initial design but has been removed from the server as LLM clients typically handle core chat functionalities directly. This server focuses on supplementary OpenAI services.)*\n    *   **Key Features**: Base64 encoded audio/image data, configurable models, voices, image sizes, and quality.\n    *   **Details**: See [`openai-mcp-server/README.md`](./openai-mcp-server/README.md)\n\n2.  ### 🦆 DuckDuckGo MCP Server (`duckduckgo-mcp-server`)\n    *   **Description**: Enables LLMs to perform anonymous web searches using the DuckDuckGo search engine.\n    *   **Current Tools**:\n        *   `duckduckgo_search`: Fetches search results (title, URL, snippet) based on a query.\n    *   **Key Features**: Configurable number of results, search region, and time-filtering.\n    *   **Details**: See [`duckduckgo-mcp-server/README.md`](./duckduckgo-mcp-server/README.md)\n\n*(More servers planned and welcomed!)*\n\n## Getting Started\n\nEach MCP server is a standalone project within its own subdirectory (e.g., `openai-mcp-server/`, `duckduckgo-mcp-server/`). Please refer to the `README.md` file within each server's directory for specific installation, configuration, and usage instructions.\n\n**General Workflow:**\n\n1.  **Clone this repository:**\n    ```bash\n    git clone https://github.com/PArisNeoMCPServers/PArisNeoMCPServers.git \u003cyour_local_path\u003e\n    cd \u003cyour_local_path\u003e\n    ```\n2.  **Navigate to the desired server directory:**\n    ```bash\n    cd openai-mcp-server # or duckduckgo-mcp-server, etc.\n    ```\n3.  **Follow the setup instructions** in that server's `README.md` (typically involving creating a virtual environment and installing dependencies with `uv pip install -e .`).\n4.  **Run the server** as described (e.g., `uv run \u003cserver-name\u003e` or `python \u003cserver_module\u003e/server.py`).\n5.  **Configure your MCP client** (e.g., LollmsClient) to connect to the running MCP server. Example client scripts are provided (e.g., `run_openai_mcp_example.py`, `run_duckduckgo_mcp_example.py`) in the root of this repository.\n\n## Requirements\n\n*   Python 3.9+\n*   `uv` (recommended for environment and package management): `pip install uv`\n*   Dependencies specific to each server (listed in their respective `pyproject.toml` files).\n\n## Contributing\n\nContributions are highly welcome! Whether it's a new MCP server, an improvement to an existing one, documentation enhancements, or bug fixes, please feel free to:\n\n1.  Fork the repository.\n2.  Create a new branch for your feature or fix.\n3.  Develop your changes.\n4.  Submit a Pull Request.\n\nPlease ensure new servers follow a similar structure and include:\n*   A `pyproject.toml` for packaging and dependencies.\n*   A clear `README.md` with setup and usage instructions.\n*   An example `.env.example` file if configuration is needed.\n*   An example client script (e.g., `run_\u003cnew_server\u003e_mcp_example.py`) in the root `PArisNeoMCPServers` directory.\n\n*(A more formal `CONTRIBUTING.md` will be added soon.)*\n\n## License\n\nThis project and all its sub-projects (MCP servers) are licensed under the **Apache License 2.0**. See the [LICENSE](LICENSE) file for more details. (You'll need to add a LICENSE file with Apache 2.0 text).\n\n---\n\nHappy building and extending your LLMs!","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fparisneo%2Fparisneomcpservers","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fparisneo%2Fparisneomcpservers","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fparisneo%2Fparisneomcpservers/lists"}