flock-mcp

What is flock-mcp?

flock-mcp is a Python package that provides multiple MCP (Model Context Protocol) servers and tools designed for use with the Flock agent framework. It offers modular installation through optional dependency groups, allowing users to install only the tools they need.

How to use flock-mcp?

Install the package via pip or uv with one of several options: the full suite (flock-mcp[all]), specific tool groups (e.g., flock-mcp[basic-tools]), or a base installation with no extras. After installation, import the desired tools in your Python code using the Flock framework’s module structure (e.g., from flock.tools.file_tools import …).

Key features of flock-mcp

• Modular installation: choose only the tool groups you need
• basic-tools: web scraping, markdown processing, and search
• azure-tools: Azure cloud integration (blob storage, search)
• llm-tools: natural language processing with NLTK
• code-tools: code analysis and containerization via Docker
• all-tools: combines all the above without extra ML dependencies
• all: includes everything plus additional ML/AI libraries

Use cases of flock-mcp

• Scrape web pages and convert content to markdown for agent workflows
• Search the web (e.g., DuckDuckGo) directly from within a Flock agent
• Integrate Azure storage and search services into agent pipelines
• Analyze codebases or manage containers using Docker tools
• Apply natural language processing for text analysis tasks

FAQ from flock-mcp

What tool groups are available in flock-mcp?

The package offers six groups: basic-tools, azure-tools, llm-tools, code-tools, all-tools, and all (which adds extra ML/AI dependencies). You can also combine multiple groups.

How do I install only the tools I need?

Use pip or uv with the corresponding bracketed extras, e.g., pip install flock-mcp[basic-tools,azure-tools] or uv add flock-mcp[code-tools].

Does flock-mcp have any required dependencies?

The base package has no main dependencies by design. All dependencies are optional and only installed when you select the relevant tool group (e.g., azure-tools installs azure-identity, azure-storage-blob, azure-search-documents).

How do I use flock-mcp servers with the Flock framework?

After installation, import the tools in your Python code using the Flock module structure. The README shows an example: from flock.tools.file_tools import file.... (specific tool names depend on the group installed).

What are the runtime requirements?

The package is a Python library installed via pip or uv. It requires Python 3.x (exact version not specified in the README) and works with the Flock agent framework. The all group adds extra ML dependencies such as datasets, rouge-score, sentence-transformers, and chromadb.