Update project metadata for Xilope0 namespace
- Change license to GPLv3+ (OSI approved) - Update repository URL to github.com/Xilope0/mcp-browser - Set correct author as Claude4Ξlope <xilope@esus.name> - Add installation instructions and badges to README - Add contributing section highlighting AI-only development - Update all metadata consistently across files 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude4Ξlope <xilope@esus.name>
This commit is contained in:
parent
fde6fdbe0c
commit
39f83ba9a9
|
|
@ -4,6 +4,11 @@
|
||||||
|
|
||||||
This repository is developed and maintained exclusively by AI assistants. All code, documentation, and design decisions are created through AI collaboration.
|
This repository is developed and maintained exclusively by AI assistants. All code, documentation, and design decisions are created through AI collaboration.
|
||||||
|
|
||||||
|
**Repository**: https://github.com/Xilope0/mcp-browser
|
||||||
|
**License**: GPLv3+
|
||||||
|
**Created**: 2025-06-27 by Claude4Ξlope
|
||||||
|
**Author**: Claude4Ξlope <xilope@esus.name>
|
||||||
|
|
||||||
## Project Overview
|
## Project Overview
|
||||||
|
|
||||||
MCP Browser is a generic, minimalistic Model Context Protocol (MCP) browser designed specifically for AI systems to interact with MCP servers while optimizing context usage.
|
MCP Browser is a generic, minimalistic Model Context Protocol (MCP) browser designed specifically for AI systems to interact with MCP servers while optimizing context usage.
|
||||||
|
|
|
||||||
40
LICENSE
40
LICENSE
|
|
@ -1,21 +1,27 @@
|
||||||
MIT License
|
GNU GENERAL PUBLIC LICENSE
|
||||||
|
Version 3, 29 June 2007
|
||||||
|
|
||||||
Copyright (c) 2024 AI Contributors
|
Copyright (C) 2024 Claude4Ξlope <xilope@esus.name>
|
||||||
|
|
||||||
Permission is hereby granted, free of charge, to any person obtaining a copy
|
This program is free software: you can redistribute it and/or modify
|
||||||
of this software and associated documentation files (the "Software"), to deal
|
it under the terms of the GNU General Public License as published by
|
||||||
in the Software without restriction, including without limitation the rights
|
the Free Software Foundation, either version 3 of the License, or
|
||||||
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
(at your option) any later version.
|
||||||
copies of the Software, and to permit persons to whom the Software is
|
|
||||||
furnished to do so, subject to the following conditions:
|
|
||||||
|
|
||||||
The above copyright notice and this permission notice shall be included in all
|
This program is distributed in the hope that it will be useful,
|
||||||
copies or substantial portions of the Software.
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||||
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||||
|
GNU General Public License for more details.
|
||||||
|
|
||||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
You should have received a copy of the GNU General Public License
|
||||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
along with this program. If not, see <https://www.gnu.org/licenses/>.
|
||||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
||||||
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
Additional permission under GNU GPL version 3 section 7
|
||||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
||||||
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
If you modify this Program, or any covered work, by linking or combining
|
||||||
SOFTWARE.
|
it with proprietary MCP servers (or a modified version of those libraries),
|
||||||
|
containing parts covered by the terms of their respective licenses, the
|
||||||
|
licensors of this Program grant you additional permission to convey the
|
||||||
|
resulting work.
|
||||||
|
|
||||||
|
For the full GPL v3 license text, see: https://www.gnu.org/licenses/gpl-3.0.txt
|
||||||
56
README.md
56
README.md
|
|
@ -2,6 +2,10 @@
|
||||||
|
|
||||||
A generic, minimalistic MCP (Model Context Protocol) browser that provides an abstract interface for AI systems to interact with MCP servers with optimized context usage.
|
A generic, minimalistic MCP (Model Context Protocol) browser that provides an abstract interface for AI systems to interact with MCP servers with optimized context usage.
|
||||||
|
|
||||||
|
[](https://www.gnu.org/licenses/gpl-3.0)
|
||||||
|
[](https://www.python.org/downloads/)
|
||||||
|
[](CLAUDE.md)
|
||||||
|
|
||||||
## Overview
|
## Overview
|
||||||
|
|
||||||
MCP Browser acts as a smart proxy between AI systems and MCP servers, providing:
|
MCP Browser acts as a smart proxy between AI systems and MCP servers, providing:
|
||||||
|
|
@ -59,6 +63,36 @@ mcp-browser/
|
||||||
└── default.yaml # Default configuration
|
└── default.yaml # Default configuration
|
||||||
```
|
```
|
||||||
|
|
||||||
|
## Installation
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Clone the repository
|
||||||
|
git clone https://github.com/Xilope0/mcp-browser.git
|
||||||
|
cd mcp-browser
|
||||||
|
|
||||||
|
# Install in development mode
|
||||||
|
pip install -e .
|
||||||
|
|
||||||
|
# Or install directly from GitHub
|
||||||
|
pip install git+https://github.com/Xilope0/mcp-browser.git
|
||||||
|
```
|
||||||
|
|
||||||
|
## Quick Start
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Run interactive mode
|
||||||
|
mcp-browser
|
||||||
|
|
||||||
|
# Run as MCP server (for chaining)
|
||||||
|
mcp-browser --mode server
|
||||||
|
|
||||||
|
# Connect to specific MCP server
|
||||||
|
mcp-browser --server claude-code
|
||||||
|
|
||||||
|
# Generate AI documentation
|
||||||
|
python setup.py aidocs
|
||||||
|
```
|
||||||
|
|
||||||
## Usage
|
## Usage
|
||||||
|
|
||||||
```python
|
```python
|
||||||
|
|
@ -105,4 +139,24 @@ All other tools (potentially hundreds) are hidden but fully accessible through t
|
||||||
1. **Generic**: No tool-specific knowledge built into the browser
|
1. **Generic**: No tool-specific knowledge built into the browser
|
||||||
2. **Minimal**: Smallest possible API surface
|
2. **Minimal**: Smallest possible API surface
|
||||||
3. **Efficient**: Optimized for minimal context usage
|
3. **Efficient**: Optimized for minimal context usage
|
||||||
4. **Transparent**: Acts as a pass-through proxy with intelligent enhancements
|
4. **Transparent**: Acts as a pass-through proxy with intelligent enhancements
|
||||||
|
|
||||||
|
## Contributing
|
||||||
|
|
||||||
|
This project is developed exclusively by AI assistants. See [CLAUDE.md](CLAUDE.md) for details about the AI-only development process.
|
||||||
|
|
||||||
|
If you're an AI assistant working on this project:
|
||||||
|
1. Read CLAUDE.md for development guidelines
|
||||||
|
2. Generate documentation with `python setup.py aidocs`
|
||||||
|
3. Test changes with the example scripts
|
||||||
|
4. Maintain context efficiency as the primary goal
|
||||||
|
|
||||||
|
## License
|
||||||
|
|
||||||
|
This project is licensed under the GNU General Public License v3.0 or later (GPLv3+) - see the [LICENSE](LICENSE) file for details.
|
||||||
|
|
||||||
|
## Acknowledgments
|
||||||
|
|
||||||
|
- Developed by Claude (Anthropic) and other AI assistants
|
||||||
|
- Inspired by the need for efficient AI-to-AI tool communication
|
||||||
|
- Built on the Model Context Protocol (MCP) standard
|
||||||
|
|
@ -3,9 +3,19 @@ MCP Browser - A generic, minimalistic MCP protocol interface.
|
||||||
|
|
||||||
Provides an abstract interface for AI systems to interact with MCP servers
|
Provides an abstract interface for AI systems to interact with MCP servers
|
||||||
with optimized context usage through sparse mode and on-demand tool discovery.
|
with optimized context usage through sparse mode and on-demand tool discovery.
|
||||||
|
|
||||||
|
Copyright (C) 2024 Claude4Ξlope <xilope@esus.name>
|
||||||
|
|
||||||
|
This program is free software: you can redistribute it and/or modify
|
||||||
|
it under the terms of the GNU General Public License as published by
|
||||||
|
the Free Software Foundation, either version 3 of the License, or
|
||||||
|
(at your option) any later version.
|
||||||
"""
|
"""
|
||||||
|
|
||||||
from .proxy import MCPBrowser
|
from .proxy import MCPBrowser
|
||||||
|
|
||||||
__version__ = "0.1.0"
|
__version__ = "0.1.0"
|
||||||
|
__author__ = "Claude4Ξlope"
|
||||||
|
__email__ = "xilope@esus.name"
|
||||||
|
__license__ = "GPLv3+"
|
||||||
__all__ = ["MCPBrowser"]
|
__all__ = ["MCPBrowser"]
|
||||||
8
setup.py
8
setup.py
|
|
@ -125,9 +125,9 @@ setup(
|
||||||
description="A generic MCP browser with context optimization for AI systems",
|
description="A generic MCP browser with context optimization for AI systems",
|
||||||
long_description=long_description,
|
long_description=long_description,
|
||||||
long_description_content_type="text/markdown",
|
long_description_content_type="text/markdown",
|
||||||
author="AI Assistant",
|
author="Claude4Ξlope",
|
||||||
author_email="ai@anthropic.com",
|
author_email="xilope@esus.name",
|
||||||
url="https://github.com/anthropics/mcp-browser",
|
url="https://github.com/Xilope0/mcp-browser",
|
||||||
packages=find_packages(),
|
packages=find_packages(),
|
||||||
package_data={
|
package_data={
|
||||||
'mcp_browser': ['py.typed'],
|
'mcp_browser': ['py.typed'],
|
||||||
|
|
@ -167,7 +167,7 @@ setup(
|
||||||
"Development Status :: 3 - Alpha",
|
"Development Status :: 3 - Alpha",
|
||||||
"Intended Audience :: Developers",
|
"Intended Audience :: Developers",
|
||||||
"Topic :: Software Development :: Libraries :: Application Frameworks",
|
"Topic :: Software Development :: Libraries :: Application Frameworks",
|
||||||
"License :: OSI Approved :: MIT License",
|
"License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)",
|
||||||
"Programming Language :: Python :: 3",
|
"Programming Language :: Python :: 3",
|
||||||
"Programming Language :: Python :: 3.8",
|
"Programming Language :: Python :: 3.8",
|
||||||
"Programming Language :: Python :: 3.9",
|
"Programming Language :: Python :: 3.9",
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue