mcp-arena 0.1.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (61) hide show
  1. mcp_arena-0.1.0/.github/workflows/python-package.yml +40 -0
  2. mcp_arena-0.1.0/.gitignore +84 -0
  3. mcp_arena-0.1.0/.python-version +1 -0
  4. mcp_arena-0.1.0/INSTALLATION.md +191 -0
  5. mcp_arena-0.1.0/LICENSE +21 -0
  6. mcp_arena-0.1.0/MANIFEST.in +4 -0
  7. mcp_arena-0.1.0/PKG-INFO +452 -0
  8. mcp_arena-0.1.0/QUICKSTART.md +158 -0
  9. mcp_arena-0.1.0/README.md +316 -0
  10. mcp_arena-0.1.0/mcp_arena/__init__.py +17 -0
  11. mcp_arena-0.1.0/mcp_arena/agent/__init__.py +165 -0
  12. mcp_arena-0.1.0/mcp_arena/agent/base.py +11 -0
  13. mcp_arena-0.1.0/mcp_arena/agent/factory.py +229 -0
  14. mcp_arena-0.1.0/mcp_arena/agent/interfaces.py +132 -0
  15. mcp_arena-0.1.0/mcp_arena/agent/memory.py +135 -0
  16. mcp_arena-0.1.0/mcp_arena/agent/planning_agent.py +341 -0
  17. mcp_arena-0.1.0/mcp_arena/agent/policies.py +266 -0
  18. mcp_arena-0.1.0/mcp_arena/agent/react_agent.py +290 -0
  19. mcp_arena-0.1.0/mcp_arena/agent/reflection_agent.py +207 -0
  20. mcp_arena-0.1.0/mcp_arena/agent/router.py +258 -0
  21. mcp_arena-0.1.0/mcp_arena/agent/state.py +110 -0
  22. mcp_arena-0.1.0/mcp_arena/agent/tools.py +283 -0
  23. mcp_arena-0.1.0/mcp_arena/examples/agent_examples.py +241 -0
  24. mcp_arena-0.1.0/mcp_arena/main.py +16 -0
  25. mcp_arena-0.1.0/mcp_arena/mcp/__init__.py +4 -0
  26. mcp_arena-0.1.0/mcp_arena/mcp/registry.py +13 -0
  27. mcp_arena-0.1.0/mcp_arena/mcp/server.py +108 -0
  28. mcp_arena-0.1.0/mcp_arena/presents/__init__.py +18 -0
  29. mcp_arena-0.1.0/mcp_arena/presents/aws.py +108 -0
  30. mcp_arena-0.1.0/mcp_arena/presents/bitbucket.py +962 -0
  31. mcp_arena-0.1.0/mcp_arena/presents/confluence.py +1031 -0
  32. mcp_arena-0.1.0/mcp_arena/presents/docker.py +1141 -0
  33. mcp_arena-0.1.0/mcp_arena/presents/github.py +1898 -0
  34. mcp_arena-0.1.0/mcp_arena/presents/gitlab.py +1208 -0
  35. mcp_arena-0.1.0/mcp_arena/presents/jira.py +1119 -0
  36. mcp_arena-0.1.0/mcp_arena/presents/local_operation.py +1185 -0
  37. mcp_arena-0.1.0/mcp_arena/presents/mongo.py +273 -0
  38. mcp_arena-0.1.0/mcp_arena/presents/notion.py +211 -0
  39. mcp_arena-0.1.0/mcp_arena/presents/postgres.py +313 -0
  40. mcp_arena-0.1.0/mcp_arena/presents/redis.py +675 -0
  41. mcp_arena-0.1.0/mcp_arena/presents/slack.py +246 -0
  42. mcp_arena-0.1.0/mcp_arena/presents/vectordb.py +284 -0
  43. mcp_arena-0.1.0/mcp_arena/tools/__init__.py +9 -0
  44. mcp_arena-0.1.0/mcp_arena/tools/base.py +17 -0
  45. mcp_arena-0.1.0/mcp_arena/tools/bitbucket.py +12 -0
  46. mcp_arena-0.1.0/mcp_arena/tools/docker.py +11 -0
  47. mcp_arena-0.1.0/mcp_arena/tools/github.py +12 -0
  48. mcp_arena-0.1.0/mcp_arena/tools/gitlab.py +12 -0
  49. mcp_arena-0.1.0/mcp_arena/tools/jira.py +12 -0
  50. mcp_arena-0.1.0/mcp_arena/tools/local_operation.py +12 -0
  51. mcp_arena-0.1.0/mcp_arena/tools/mongo.py +12 -0
  52. mcp_arena-0.1.0/mcp_arena/tools/notion.py +12 -0
  53. mcp_arena-0.1.0/mcp_arena/tools/postgres.py +12 -0
  54. mcp_arena-0.1.0/mcp_arena/tools/redis.py +12 -0
  55. mcp_arena-0.1.0/mcp_arena/tools/slack.py +12 -0
  56. mcp_arena-0.1.0/mcp_arena/tools/vectordb.py +12 -0
  57. mcp_arena-0.1.0/mcp_arena/wrapper/agent_wrapper.py +192 -0
  58. mcp_arena-0.1.0/mcp_arena/wrapper/langchain_wrapper.py +742 -0
  59. mcp_arena-0.1.0/pyproject.toml +161 -0
  60. mcp_arena-0.1.0/requirement.txt +0 -0
  61. mcp_arena-0.1.0/requirements.txt +35 -0
@@ -0,0 +1,40 @@
1
+ # This workflow will install Python dependencies, run tests and lint with a variety of Python versions
2
+ # For more information see: https://docs.github.com/en/actions/automating-builds-and-tests/building-and-testing-python
3
+
4
+ name: Python package
5
+
6
+ on:
7
+ push:
8
+ branches: [ "main" ]
9
+ pull_request:
10
+ branches: [ "main" ]
11
+
12
+ jobs:
13
+ build:
14
+
15
+ runs-on: ubuntu-latest
16
+ strategy:
17
+ fail-fast: false
18
+ matrix:
19
+ python-version: ["3.9", "3.10", "3.11"]
20
+
21
+ steps:
22
+ - uses: actions/checkout@v4
23
+ - name: Set up Python ${{ matrix.python-version }}
24
+ uses: actions/setup-python@v3
25
+ with:
26
+ python-version: ${{ matrix.python-version }}
27
+ - name: Install dependencies
28
+ run: |
29
+ python -m pip install --upgrade pip
30
+ python -m pip install flake8 pytest
31
+ if [ -f requirements.txt ]; then pip install -r requirements.txt; fi
32
+ - name: Lint with flake8
33
+ run: |
34
+ # stop the build if there are Python syntax errors or undefined names
35
+ flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics
36
+ # exit-zero treats all errors as warnings. The GitHub editor is 127 chars wide
37
+ flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics
38
+ - name: Test with pytest
39
+ run: |
40
+ pytest
@@ -0,0 +1,84 @@
1
+ # Byte-compiled / optimized / DLL files
2
+ __pycache__/
3
+ *.py[cod]
4
+ *$py.class
5
+
6
+ # C extensions
7
+ *.so
8
+
9
+ # Distribution / packaging
10
+ .Python
11
+ build/
12
+ develop-eggs/
13
+ dist/
14
+ downloads/
15
+ eggs/
16
+ .eggs/
17
+ lib/
18
+ lib64/
19
+ parts/
20
+ sdist/
21
+ var/
22
+ wheels/
23
+ pip-wheel-metadata/
24
+ share/python-wheels/
25
+ *.egg-info/
26
+ .installed.cfg
27
+ *.egg
28
+ MANIFEST
29
+
30
+ # PyInstaller
31
+ *.manifest
32
+ *.spec
33
+
34
+ # Unit test / coverage reports
35
+ htmlcov/
36
+ .tox/
37
+ .nox/
38
+ .coverage
39
+ .coverage.*
40
+ .cache
41
+ nosetests.xml
42
+ coverage.xml
43
+ *.cover
44
+ *.py,cover
45
+ .hypothesis/
46
+ .pytest_cache/
47
+
48
+ # Virtual environments
49
+ .venv/
50
+ .virtualenv/
51
+ env/
52
+ venv/
53
+ ENV/
54
+ env.bak/
55
+ venv.bak/
56
+
57
+ # IDE
58
+ .vscode/
59
+ .idea/
60
+ *.swp
61
+ *.swo
62
+ *~
63
+ .DS_Store
64
+
65
+ # Environment variables
66
+ .env
67
+ .env.local
68
+ .env.*.local
69
+
70
+ # Logs
71
+ *.log
72
+ logs/
73
+
74
+ # Databases
75
+ *.db
76
+ *.sqlite
77
+ *.sqlite3
78
+
79
+ # OS
80
+ .DS_Store
81
+ Thumbs.db
82
+
83
+ # Project specific
84
+ uv.lock
@@ -0,0 +1 @@
1
+ 3.12
@@ -0,0 +1,191 @@
1
+ # Installation Guide
2
+
3
+ ## Quick Start
4
+
5
+ ### Install Core Library
6
+ ```bash
7
+ pip install mcp_arena[core]
8
+ ```
9
+
10
+ ### Install with Specific MCP Server
11
+ Each MCP server preset can be installed separately using extras:
12
+
13
+ #### Development Platforms
14
+ ```bash
15
+ # GitHub MCP Server
16
+ pip install mcp_arena[github]
17
+
18
+ # GitLab MCP Server
19
+ pip install mcp_arena[gitlab]
20
+
21
+ # Bitbucket MCP Server
22
+ pip install mcp_arena[bitbucket]
23
+ ```
24
+
25
+ #### Data & Storage
26
+ ```bash
27
+ # PostgreSQL MCP Server
28
+ pip install mcp_arena[postgres]
29
+
30
+ # MongoDB MCP Server
31
+ pip install mcp_arena[mongodb]
32
+
33
+ # Redis MCP Server
34
+ pip install mcp_arena[redis]
35
+
36
+ # Vector Database MCP Server
37
+ pip install mcp_arena[vectordb]
38
+ ```
39
+
40
+ #### Communication Platforms
41
+ ```bash
42
+ # Slack MCP Server
43
+ pip install mcp_arena[slack]
44
+
45
+ # Discord MCP Server
46
+ pip install mcp_arena[discord]
47
+
48
+ # Microsoft Teams MCP Server
49
+ pip install mcp_arena[teams]
50
+ ```
51
+
52
+ #### Productivity Tools
53
+ ```bash
54
+ # Notion MCP Server
55
+ pip install mcp_arena[notion]
56
+
57
+ # Confluence MCP Server
58
+ pip install mcp_arena[confluence]
59
+
60
+ # Jira MCP Server
61
+ pip install mcp_arena[jira]
62
+ ```
63
+
64
+ #### Cloud Services
65
+ ```bash
66
+ # AWS MCP Server
67
+ pip install mcp_arena[aws]
68
+
69
+ # Azure MCP Server
70
+ pip install mcp_arena[azure]
71
+
72
+ # Google Cloud MCP Server
73
+ pip install mcp_arena[gcp]
74
+ ```
75
+
76
+ #### System Operations
77
+ ```bash
78
+ # Local Operations MCP Server
79
+ pip install mcp_arena[local_operation]
80
+
81
+ # Docker MCP Server
82
+ pip install mcp_arena[docker]
83
+
84
+ # Kubernetes MCP Server
85
+ pip install mcp_arena[kubernetes]
86
+ ```
87
+
88
+ #### Agent Framework
89
+ ```bash
90
+ # Agent dependencies (for using agents)
91
+ pip install mcp_arena[agents]
92
+ ```
93
+
94
+ ### Install All Presets
95
+ ```bash
96
+ # All MCP server presets (no dev dependencies)
97
+ pip install mcp_arena[all]
98
+
99
+ # Complete installation (includes dev tools)
100
+ pip install mcp_arena[complete]
101
+ ```
102
+
103
+ ### Install from Source
104
+ ```bash
105
+ git clone https://github.com/mcp_arena/mcp_arena.git
106
+ cd mcp_arena
107
+ pip install -e .
108
+ ```
109
+
110
+ ### Development Installation
111
+ ```bash
112
+ # Install with development dependencies
113
+ pip install -e .[complete]
114
+
115
+ # Or install core + dev tools only
116
+ pip install -e .[core,dev]
117
+ ```
118
+
119
+ ## Configuration
120
+
121
+ 1. Copy `.env.example` to `.env`:
122
+ ```bash
123
+ cp .env.example .env
124
+ ```
125
+
126
+ 2. Update `.env` with your credentials:
127
+ ```env
128
+ # For GitHub MCP
129
+ GITHUB_TOKEN=your_github_token
130
+
131
+ # For Slack MCP
132
+ SLACK_BOT_TOKEN=your_slack_token
133
+
134
+ # For Notion MCP
135
+ NOTION_API_KEY=your_notion_key
136
+
137
+ # etc.
138
+ ```
139
+
140
+ ## Running Your First MCP Server
141
+
142
+ ```python
143
+ from mcp_arena.mcp.server import BaseMCPServer
144
+ from mcp_arena.presets.github import GithubMCPServer
145
+
146
+ # Create GitHub MCP Server
147
+ server = GithubMCPServer(token="your_token")
148
+
149
+ # Start the server
150
+ server.run()
151
+ ```
152
+
153
+ ## Testing Installation
154
+
155
+ ```bash
156
+ python -c "from mcp_arena import BaseMCPServer; print('✓ mcp_arena installed successfully')"
157
+ ```
158
+
159
+ ## Troubleshooting
160
+
161
+ ### Missing Dependencies
162
+ If you get import errors, make sure you installed the correct optional dependencies:
163
+
164
+ ```bash
165
+ # For GitHub
166
+ pip install mcp_arena[github]
167
+
168
+ # For agents
169
+ pip install mcp_arena[agents]
170
+
171
+ # For all presets
172
+ pip install mcp_arena[all]
173
+ ```
174
+
175
+ ### Python Version
176
+ Ensure you're using Python 3.12 or higher:
177
+ ```bash
178
+ python --version
179
+ ```
180
+
181
+ ### Import Errors
182
+ If you encounter import errors, try installing the core dependencies first:
183
+ ```bash
184
+ pip install mcp_arena[core]
185
+ ```
186
+
187
+ ## Next Steps
188
+
189
+ - Read the [README.md](README.md) for core concepts
190
+ - Check out examples in the `examples/` directory
191
+ - See [CONTRIBUTING.md](CONTRIBUTING.md) for development guidelines
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2024 mcp_arena
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -0,0 +1,4 @@
1
+ include README.md
2
+ include LICENSE
3
+ include requirements.txt
4
+ recursive-include mcp_arena *.py